Introduction
The DotNetNuke (DNN) web application framework provides a
feature-rich environment. The framework is dependent on several components and
small changes to the sequence and or settings can create frustrating
situations. For that reason I have created these instructions as much for
myself as the DNN community.
Requirements
·
Windows XP
·
Internet Information Services (IIS) Version 5.0
·
SQL Server 2005 Express
·
SQL Server Management Studio Express (SSMSEE)
Optional:
·
Visual Web Developer 2008 (VWD)
Create DotNetNuke Web Site
1. Download
DotNetNuke Community Edition (4.x or 5.x)
2.
Download the Install Version. It targeted for website and module
development whereas the source version is intended for core development.
3.
Extract the files to a folder below \Inetpub, which is the default
website folder for IIS.
NOTE: Extracting the files below the wwwroot
folder is not recommended because of permission issues.
4.
In Windows Explorer Open the [New Directory]\App_Data folder. Rename the
default of “Database.mdf” to a unique name, e.g.: to match the folder name
(in this example “DNNCHP”). This will reduce the confusion when using SQL
Express to manage to manage multiple DNN databases as well as confusion when
backing up and restoring multiple sites.
5.
Open Internet information Services (IIS), which can be found under
Control Panel > Administrative Tools.
NOTE: If not found then use Control
Panel > Add or Remove Programs > Add/Remove Windows Components
Screenshot from Windows XP Media
Center Edition
6.
Expand the XXX (local computer)\Web Sites\Default Web Site path.
7.
Right click and select New > Virtual Directory
8.
Click Next.
9.
Enter the Virtual Directory Alias. Using the same name as the folder
will minimize confusion.
10. Click
Next.
11. Click
Browse and select the new directory.
12. Click
Next.
13. Verify
"Read", "Run scripts permissions.
14. Click
Next.
15. Click
Finish.
16. Right-click
on the new Virtual Directory and select Properties.
17. Select
the ASP.NET tab.
18. Select
ASP.NET version 2.0.x.
19. Click
Apply.
20. Select
the Documents tab. Add Default.aspx to the list if not present.
21. Click OK.
Set Folder Security
1.
Open Windows Explorer. Right-click on the new directory and select
Sharing and Security. . .
2.
Select the Security tab.
NOTE: If the security tab is not
visible go to Tools > Folder Options on the Explorer menu. Open the View
tab, then scroll to end of the list and clear (uncheck) the “Use simple file
sharing” checkbox.
3.
Click Add. . .
4.
For IIS V5: Enter [Machine Name]\aspnet in the “object names to select”
text box. Then click Check Names.
NOTE: For IIS V6: Enter [Machine
Name]\networkservice. Then repeat process for [Machine Name]\iusr_[Machine
Name].
5.
Click OK
6.
In the Security tab select “Full Control” for the ASP.NET account.
7.
Click OK
Run DotNetNuke Install Wizard
1.
Open Internet Explorer.
2.
Enter localhost/[New Directory] into the address and press Enter.
3.
If HTTP 403 Forbidden error. Verify that Default.aspx is present as
ASP.NET default document.
4.
Click Next.
5.
Click Test Permissions.
6.
Click Next (Configure Database Connection).
NOTE: The explicit format of
[Machine Name]\SQLEXPRESS is equivalent to .\SQLEXPRESS.
7.
Click Test Database Connection.
8.
Click Next (Run database installation Scripts).
9.
Click Next.
10. Modify
Host User User Name, set Password and Email Address. Changing the default from “host”
reduces risk of website hacking. NOTE: The domain name (e.g.: mydomain.com) of
the Email Address must match an available SMTP service in order for DNN to send
e-mail.
11. Click
Next.
12. Modify
Portal Administrator User Name and set Password and Email Address. Changing the
default from “admin” reduces risk of website hacking. NOTE: The e-mail domain of
the host address must match an available SMTP service in order for DNN to send
e-mail.
13. Click
Next
14. Click
Finished (Goto Site)
Optional: Enable Database for Multiple Access
1. Log off
of Windows and then log on (in order to prevent SQL error: “. . . cannot access
the file because it is being used by another process . . .”).
2. Start SQL Server Management Studio Express
3. Select
local server instance (e.g.: [Machine Name]\SQLEXPRESS) and Windows
Authentication.
4. Right-click
on Databases and select Attach
5. Below
Databases to Attach click Add. . .
6. Browse
to select the Database.mdf file below C:\Inetpub\[DNN Folder]App_Data.
NOTE: If you receive a “cannot access the file” then log off of Windows, log
on, and retry the attach command.
7. Click
OK to finish the attachment. Then right-click on the new database, select
Rename and modify name to match the folder (this minimizes confusion as
additional databases are added).
8. Re-open
Internet Information Services
9. Right-click
on [New Website]. Select Properties
10. Click
ASP tab then click Edit Configuration. This will make changes to the ASP.NET
Configuration Settings contained in the root directory Web.Config file (e.g.:
C:\Inetpub\dnnchp\Web.Config).
11. Under Connection
string manager select SiteSqlServer then click Edit.
12. Change
string to: Data Source=[Local machine name]\SQLEXPRESS;Initial
Catalog=[Database name in SQL Express];Integrated Security=True
13. Click
OK
14. Under
Application settings select SiteSqlServer then click Edit.
15. Change
string to: Data Source=[Local machine name]\SQLEXPRESS;Initial
Catalog=[Database name in SQL Express];Integrated Security=True
16. Click
OK. Now SQL Server Management Studio Express or Visual Web Developer can be
connected to the database at the same time as the website in a browser window
without the dreaded DNN “This site is currently Unavailable” error message.
17. Congratulations!
You now have a new instance of a DotNetNuke Web Site ready for development!
Setting-up Your DotNetNuke Version 4 Development
Environment.
http://www.adefwebserver.com/DotNetNukeHELP/DNN4_DevelopmentEnvironment/DNN4DevelopmentEnvironment1.htm
Easy DotNetNuke Installation Guide 4.9.5 and 5.2.3
http://www.bestwebsites.co.nz/dotnetnuke/easy-dotnetnuke-installation-guide
A nearly complete list of DotNetNuke install, upgrade and
other related guides
http://www.bestwebsites.co.nz/dotnetnuke/long-list-of-dotnetnuke-install-and-upgrade-guides/
|
|
|
|
|
|
1.0.0
|
August 23, 2009
|
Chris Miller
|
-Initial release
|
|
1.1
1.2
1.3
|
August 24, 2009
January 2, 2010
March 18, 2010
|
Chris Miller
Chris Miller
Chris Miller
|
- Moved data source change to after DNN install Wizard
and SQL attach rather than before.
- Instructions also work with version 5.02.01
- Added notes regarding folder security.
|