|
|
| |
| |
| |
|
|
Mitchel Sellers' DotNetNuke, .NET, and Other Topics Blog
|
 |
|
|
| |
Subscribe To Blog Updates by E-Mail
|
|
|
| |
|
|
| |
Installing DotNetNuke 4.8.0 Locally
By Mitchel Sellers on Wednesday, January 16, 2008 @ 9:58 AM
|
|
| |
1693 Views ::
13 Comments :: :: DotNetNuke, Tutorials
|
|
|
| |
Installing DotNetNuke can be somewhat difficult at times, therefore I am writing this article to give you a full step by step guide to installing DotNetNuke on a Windows XP Pro system. The instructions are similar for Windows 2000 but might vary slightly, I have tried to note as many differences as possible. Windows Vista installation is similar but requires a few different steps relating to IIS. for Vista information please view my video tutorial. This guide is my fifth revision and includes additional steps and information based on feedback from previous users.
Prior to following this instruction guide please ensure that you have downloaded the "install" version of DotNetNuke 4.8.0 from http://www.dotnetnuke.com. You can save the zip file to your desktop for the time being. You will also need to have SQL Server Express 2005 installed and correctly configured to allow
mixed-mode authentication. You can use windows authentication only, however,
that configuration is NOT discussed in this article. (Other SQL Server versions work, but these instructions might not match 100% if using something other than
2005). You must also be logged into your machine with administrative permissions.
The setup will be broken into the following 4 sections; pre-requisites/disclaimer, creating the needed SQL Serveer database and user account, unzipping DNN and configuring the web.config file, and finally setup of the virtual directory and starting DotNetNuke.
Pre-Requisities / Disclaimer
Before we start with the tutorial I would like to start by explaining what will be covered and what must be configured PRIOR to using this guide. This guide assumes that you have a SQL Server 2005 Express Database instance running on your machine that has been configured for mixed-mode authentication and to allow external connections. This guide also assumes that you have IIS and ASP.NET 2.0 installed and correctly enabled. The last assumption that is made with this tutorial is that you have "simple file sharing" turned off for your Windows installation.
This can be completed by adjusting the setting under "Folder Options".
If you have any concerns regarding any of these items, please post a question in my support forum as these items all must exist and be configured properly as a baseline before this guide can walk you through the DNN installation. Incorrect cofiguration of any pre-requisites will cause unreliable error messages and will make for a longer troubleshooting process.
Creating SQL Server Database
The first step of this process is to create a deducated SQL Server database for
your DotNetNuke installation. DotNetNuke by default is configured to dynamically
attach a database to your SQL Server Instance, I do NOT recommend to use that method
as it provides for more complex administration items in the future. The below
steps will guide you through the creation of a new database for usage by DNN.
If you want to install DotNetNuke inside of another database you can skip these
steps as long as you know the connection information to the existing system.
- Start SQL Server Management Studio Express (SSMSE), (if you don't have this please install it from here.)
- Once SSMSE has opened, please note the "Server Name" of the server that you are connecting to, this is the full text of the information in that field.
- Once you have connected and opened the utility you will want to expand the node for your server name as located in step 2
- Right Click on the "Databases" node and select "Create New Database"
- Specify a name for your database, I will use DotNetNuke47 for this example, then click create
- Now expand the "Security" node, then right click on "Logins" and select add
- Provide the information for the dnn account, be sure to select "SQL Server Authentication" and remember the password. (If SQL Server Authentication is not available see this to enable mixed mode on your server)
- Now select "User Mappings" and check the box next to your newly created database at the top, then select the "dbowner" role from the listing at the bottom, this maps the account to have full access to your database.
- Click "Create" to have your user account created. Once this is completed you are now done with the databse setup. Please remember the database server name from step two and the username and password used to create the SQL Server account as we will be using this in the next section
Unzipping and Configuring DotNetNuke
All files from the DotNetNuke install zip must be extracted to a common folder, typically this folder is created as a sub directory of C:\inetpub\wwwroot. The instructions below will be based on installation to this location, if you desire to install DotNetNuke at a different location simply substitute your folder path anytime it is referenced in the below instructions.
- Using windows explorer navigate to c:\inetpub\wwwroot, then right click and select "New" -> "Folder" and create a folder called "DotNetNuke48".
This folder will become the install directory for DotNetNuke
- Right click on your newly created folder and select "Sharing and Security"
- Switch to the security tab, if you do not see the "Security" tab, you will need to disable the "Use Simple File Sharing" option in your Folder View Options. For assistance with turning off simple file sharing please visit the forums
- Click "Add.."
- In the textbox type ASPNET if on Windows 2000/XP or NETWORK SERVICE if on Windows 2K3/Vista, then press ok
- Under permissions for this account check the box for full control, then press "Ok" to save the changes
- Open the DotNetNuke 4.8.0 Install Zip package
- Select "Extract All Files/Folders"
- For the extraction location select the folder you created in step 1
- Once all files have been extracted you need to edit the "Web.config" file located in the root of the DotNetNuke folder
- Modify the circled sections of the web config, you will need to set this up to connect to your database, so substitute your values for "Server", "Database", "uid", and "pwd". This format of connection string will work for both SQL 2000 and SQL Express. You may use other valid connection string settings, you may visit http://www.connectionstrings.com for assistance with other formats NOTE: be sure to use your proper values for the connection string, this image is for example purposes only and is from an older version of this guide, thus the different database name.

- Also inside the web.config look for a setting called <add name="AutoUpgrade" value="True" />, change the value on this to "False"
- Lastly inside the web.config look for a setting called <add name="UseInstallWizard" value="True" />, change the value on this to "False"
- If you desire you can specific ObjectQualifier and DatabaseOwner values in the DataProvider
section of the web.config to isolate the tables and procedures on this installation.
(This is only recommended if you intend on installing two DNN sites to 1 database)
- Save the modified document
The above finishes the actual configuration of the DotNetNuke file system first we created the needed directory, then we assigned the proper file permissions, then we configured the web.config file to not only connect to the database but to also do some preventative settings changes to secure the site. The changes to AutoUpgrade and UseWizard are to ensure that you are the individual that triggers the installation and to bypass the wizard since we have configured the web.config.
Setup Virtual Directory and Start DotNetNuke
Now that we have the database and file system setup we will proceed to the final step of setup, configuring IIS to host your website.
- Open the IIS Snap-In tool, this can be found via "Start" -> "Settings" -> "Control Panel" -> "Administrative Tools" -> "Internet Information Services"
- Expand the root notes until you can expand the "Default Web Site" node

- You should see your application folder listed under the "Default Web Site", right click on the folder and select "Properties"
- On the first tab, click the "Create" button next to the application name, you should then see DotNetNuke48 listed

- Now, switch to the "Documents" tab. Remove all current entries and add "Default.aspx" to the listing. Your window should look like the following when complete.

- Now, switch to the "Directory Security" tab
- Click "Edit" in the "Anonymous access and authentication control"
- Ensure that a checkmark is included in the "Anonymous Access" box at the top of the screen then click "Ok" to exit
- Now switch to the "ASP.NET" tab and ensure that "2.0.50727" is selected for the ASP.NET version
- Click "Ok" to save your changes and complete the IIS setup
This now completes the IIS setup. NOTE: If you are using Windows Vista the above steps are much different, please view my video tutorial for a step by step walk-through of the Vista IIS setup. I will work to get a text based tutorial for Vista up soon!
Now that we have everything configured it is time to start the installation process, you can do this by opening Internet Explorer and navigating to "http://localhost/dotnetnuke48/install/install.aspx".
This should trigger the DNN installation process, if you are directed towards the "UnderConstruction.htm" page simply try navigating to the install page a second time, I have noticed a sporadic bug in DNN that causes this to occur in special circumstances. Once the installation is completed you should see a link that says "Click here to access your portal", once you click this link you will have your new site up and going. Be sure that you click on this
link, if you do not it is possible that your DNN portal alias will be configured
incorrectly.
This walks you through the entire setup process to get a local copy of DotNetNuke working with SQL Server 2005 Express, for installation on a hosting provider please see my other tutorials.
If you have any comments please leave them below, if you have any trouble and need assistance please utilize my forum to request assistance!
|
|
|
|
|
|
| |
| |
| |
Share/Save This Article |
|
| |
Use the below controls to save this article to one of many popular social bookmarking sites!
|
|
|
|
|
| |
| |
| |
Article Comments |
|
| |
By
Roland @
Monday, February 04, 2008 10:05 PM
|
Hmm, everything installing without any problems, but on the end, configuring the IIS-server, it fails.
I get a 404-error, page cannot be found. Must I make a virtual directory (so the original manual says) or do I maybe something else wrong?
|
|
|
By
Mitchel Sellers @
Tuesday, February 05, 2008 6:08 AM
|
If you are installing to the root of a website it is just fine to install, but your links will be different to get to the install page
Also if you are on windows 2003 server, ensure in the web extensions that the "Check file exists" option is NOT checked!
|
|
|
By
Roland @
Tuesday, February 05, 2008 11:19 PM
|
Thanks for your answer Mitchel, I've got it.
In IIS on my Windows 2003 Server, I looked to the Web Service Extensions, and I set the ASP.NET parameter to ALLOWED. Just a try...and it works!
Maybe you can write this at the end of the manual? I don't know if this happens on every installation of DNN...
Many thanks for the quick answer and (of course) the great and complete manual for the installation. Greetings from the Netherlands!
|
|
|
By
Mitchel Sellers @
Wednesday, February 06, 2008 5:16 AM
|
|
I will make a note to add this to the next revision of this tutorial.
|
|
|
By
Dave Colbeck @
Thursday, February 07, 2008 6:41 AM
|
I managed to get this all working and it's pretty straightforward, with the exception of the connection string. I tried the method in the article, and I get an error connecting to the SQL Server. I enables TCP/IP and Named Pipes on the SQL Server to no avail. I finally got it to work using the DNN install doc, but I still don't think something is correct.
On a couple of modules, media and event to be exact, I continually get errors that I cannot open the databse file, that it already exists, permissions, etc.
Any tips?
Cheers Dave
|
|
|
By
Mitchel Sellers @
Thursday, February 07, 2008 6:57 AM
|
Dave,
I would ensure that both connection string values are the same. The one in the ConnectionStrings section and the one in the AppSettings section.
|
|
|
By
Dave Colbeck @
Thursday, February 07, 2008 7:35 AM
|
Mitchel,
Here are my connection strings that work (sort of):
<connectionStrings> <!-- Connection String for SQL Server 2005 Express --> <add name="SiteSqlServer" connectionString="Data Source=.\SQLExpress;Integrated Security=True;User Instance=True;AttachDBFilename=|DataDirectory|database.mdf" providerName="System.Data.SqlClient" />
<appSettings> <!-- Connection String for SQL Server 2005 Express - kept for backwards compatability - legacy modules --> <add key="SiteSqlServer" value="Data Source=.\SQLExpress;Integrated Security=True;User Instance=True;AttachDBFilename=|DataDirectory|cc316.mdf;uid=xxxxx;pwd=xxxxx" />
When I set them both to the same, I get this right from the start:
An attempt to attach an auto-named database for file c:\inetpub\wwwroot\ccc316\App_Data\cc316.mdf failed. A database with the same name exists, or specified file cannot be opened, or it is located on UNC share.
Now the database does not exist there because I created it from SSMSE and it exists in the data directory under program files. Should this be moved?
|
|
|
By
Mitchel Sellers @
Thursday, February 07, 2008 8:34 AM
|
You should switch your connection strings away from the dynamic attachment format, to the format specified in the guide that designates a specific Database that exists on your server.
If you need further assistance, please move this discussion to my forum.
|
|
|
By
Bill Swanson @
Saturday, February 23, 2008 2:18 PM
|
Excellent tutorial.
How do I get past this error? Line 31: Namespace YourCompany.Modules.$fileinputname$
|
|
|
By
Mitchel Sellers @
Saturday, February 23, 2008 2:23 PM
|
|
It sounds like you have a custom module that is creating errors.
|
|
|
By
Jonathan @
Friday, March 07, 2008 4:54 PM
|
Hi, I just finished your tutorial and all went well with the exception of one error. At the end, when i run the "http://localhost/dotnetnuke48/install/install.aspx" address in IE, i get an error message that says "Failed to access IIS metabase" im not sure what this means. Thanks in advance,
Jonathan
|
|
|
By
Mitchel Sellers @
Saturday, March 08, 2008 8:07 AM
|
Jonathan,
That error is caused when you have installed IIS after ASP.NET. There are 2 simple commands that you have to run to fix it.
If you can make a post in the forum I'll get you going, I just want to try and keep the comments here clean from individual troubleshooting issues.
|
|
|
By
Tena @
Wednesday, May 14, 2008 5:07 AM
|
|
Great tutorial. But I still get an XML can't be displayed as XSL error:Cannot view XML input using XSL style sheet.
|
|
|
Click here to post a comment
|
|
|
|
|
 |
|
|
|
|
|
|
|
|
| |
| |
| |
|
|
Archive
|
 |
|
|
| |
|
|
|
|
|
| |
| |
| |
|
|
Categories
|
 |
|
|
| |
|
|
|
|
|
| |
| |
| |
|
|
Donate
|
 |
|
|
| |
|
|
|
|
|
|