Installing umbraco on Windows Server 2003 is very simple and quick.
Beginning with umbraco v3.0.3, you can use the automated MSI installer. These instructions, however, demonstrate in detail every step that is required for a manual installation of umbraco.
Prerequisites
These instructions assume you have already installed and configured the following items on your server(s).
•Windows Server 2003
•IIS
•Microsoft .NET Framework 2.0
•Microsoft ASP.NET 2.0 AJAX Extensions 1.0
•Microsoft SQL Server 2005
Note: Be sure that the TCP/IP protocol is enabled via the SQL Server Configuration Manager
INSTALL SQL Server Management Studio
1.Click Start, click All Programs, click Microsoft SQL Server 2005, and click SQL Server Management Studio.
2.Connect to the database server with an account that has sufficient permissions to create a new database. Contact your database system administrator if you are unsure how to log in.
3.Click Connect.
4.Right-click on the Databases folder, and select New Database.
5.Enter a Database name.
(we’ll use ‘umbracoCMS’ in these instructions)
6.Leave the Owner as .
7.Click OK.
8.Expand the Security folder.
9.Right-click on the Logins folder, and select New Login.
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)
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
3.Click OK.
12.Right-click on the root server folder (the parent of Databases, Security, etc.), and select Properties.
13.Select the Security page:
1.Select the radio button next to “SQL Server and Windows Authentication mode”.
2.Click OK.
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..
4.Click Options.
5.Select the Connections Properties tab.
6.Select TCP/IP as the Network Protocol.
7.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
Install umbraco 3.0 Files
These instructions were created using umbraco 3.0.3.
IIS on Windows Server can host a large number of web sites. If you already have web site content in C:\Inetpub\wwwroot (the Default Web Site), create a new web site and corresponding root folder with the IIS Manager and extract the files and folders into that new location (such as, C:\Inetpub\umbracoRoot). These instructions will use the default web site.
Note that umbraco 3.x does not support being installed in virtual directories.
1.Download the binaries for umbraco 3.0 from the umbraco web site at:
http://www.codeplex.com/umbraco/Release/ProjectReleases.aspx?ReleaseId=6344
2.Save the v303.zip file to your desktop.
3.When downloading has finished, double-click the v303.zip file on your desktop.
4.Click Extract all files.
5.Follow the wizard to extract all files and folders to C:\Inetpub\wwwroot
Note: it is vital that you keep the file and folder structure intact!
Set file permissions
You will need to set file permissions to allow umbraco to create and update its files.
1.Using My Computer or the Windows Explorer, navigate to the folder containing the umbraco web site files.
Note: C:\Inetpub\wwwroot, according to these instructions.
2.Hold down the CTRL key, and click the following folders to select them:
bin
config
css
data
media
python
scripts
umbraco
usercontrols
xslt
1.Right-click on any of the selected folders, click Properties.
2.On the Security tab, click Add.
3.Click Locations.
4.Select the local machine (or domain controller if it is the local machine)
5.Type NETWORK SERVICE into the “Enter the object names to select” text box.
(Note: NETWORK SERVICE is the default owner of the web site’s application pool in IIS. If you have changed the application pool to another user, enter that username here)
6.Click Check Names.
Note: the text field should change to NETWORK SERVICE, and underline the name, indicating the account has been found and validated.
7.Click OK.
8.On the Security tab, click the NETWORK SERVICE user name.
9.Place a check mark in the box next to Full Control, in the Allow column.
10.Click OK.
3.Click the web.config file and repeat the steps above
Configure IIS for umbraco
1.Click Start, click Administrative Tools, and click Internet Information Services (IIS) Manager.
2.Expand the (local computer) folder, expand the Web Sites folder, and click on Default Web Site.
Note: if you extracted the umbraco files to a folder other than C:\Inetpub\wwwroot, select the website that corresponds to that file location.
3.Right-click on Default Web Site, click on Properties.
4.On the ASP.NET tab, select ASP.NET version of 2.0.xxxxx.
5.You may also need to add default.aspx as the top-most entry on the Documents tab if it is not already present.
6.Click OK.
Configure IIS for umbraco
1.Click Start, click Administrative Tools, and click Internet Information Services (IIS) Manager.
2.Expand the (local computer) folder, expand the Web Sites folder, and click on Default Web Site.
Note: if you extracted the umbraco files to a folder other than C:\Inetpub\wwwroot, select the website that corresponds to that file location.
3.Right-click on Default Web Site, click on Properties.
4.On the ASP.NET tab, select ASP.NET version of 2.0.xxxxx.
5.You may also need to add default.aspx as the top-most entry on the Documents tab if it is not already present.
6.Click OK.
Configure umbraco 3.0
You will need to edit the web.config file to specify the location and connection string information for your database.
1.Using My Computer or the Windows Explorer, navigate to the folder containing the umbraco web site files.
Note: C:\Inetpub\wwwroot, according to these instructions.
2.Double-click the Web.config file.
3.If prompted, select the radio button next to “Select a program from a list of installed programs”, click OK, click Notepad, place a check mark in the box next to “Always use the selected program to open this kind of file”, and click OK.
4.Near the middle of the file, find the following line:
5.Modify the following umbracoDbDSN items to match your database configuration.
Note: according to these instructions, the values would be:
1.Server=127.0.0.1
Database=umbracoCMS
User ID=umbracoUser
Password=denmark
Trusted_Connection=False
6.Save the Web.config file.
Set up umbraco from a web browser
1.Using a web browser, navigate to http://localhost.
2.Click Next.
3.Your database should be found and identified as None, meaning your database is empty.
Note: If your database is not found or is unavailable, double-check your umbracoDbDSN settings in the web.config file.
4.Click Install.
5.Click Next.
6.Click Next.
Note: If there are any permission problems, return to Set File Permissions, above.
7.Enter a password for the umbraco user interface, and click Change Password.
8.Click Next.
9.Click Next.
10.Finally, delete or rename the \install folder
Note: C:\Inetpub\wwwroot\install, according to these instructions.
Congratulations!
You are now ready to start creating an umbraco website!
Please note that if you now browse to http://localhost, you will see the following page because the umbraco web site does not yet have any content.
Log in to the umbraco interface
1.Navigate to http://localhost/umbraco, or click the Launch umbraco button shown above.
2.The username is admin.
3.The password is that which you entered when you set up umbraco from your web browser, above.
4.Once you have logged in, you will see the full umbraco interface.
Installing a Website Starter Kit (optional)
1.Click the Developer section icon, and then right-click on Macros to select the Import Package item.
2.Click the Go to the package repository link
3.Select the Website Packages section to view a list of sample websites.
