First time here? You may want to check out the blog archive, subscribe to the RSS feed, sign up for free email updates, or follow me on Twitter. Thanks for visiting!

Creating a DNN Parent Portal 

This post was inspired by a question in the dotnetnuke.com forums and continues our “DNN for Beginners” series.

I am new to DNN and I am looking for instructions on installing one portal per domain name. These portals are independent of each other. I want them to use the same SQL Server database and use the same DNN code base (the same Dlls).

The ability to run multiple websites from one DNN installation has been touted by many as the number one feature over the years (especially in DNN’s infancy), even though I beg to differ. That’s food for another post though.

DNN allows you set up a second website or portal on your install as a “parent” or “child” portal. The only real difference is that parent portals have a unique domain name, whereas child portals run off of parent portals such as mysite.com/childportal.

To get back to the above question, here is how to create a parent portal. Login as SuperUser and navigate to Host | Portals. Here you’ll see a list of all portals running on this DNN install. From the action menu choose Add New Portal.

DNN Portals

“Parent” is checked by default as the Portal Type, so no need to change that. Next, enter the domain name the new site will live on into the Portal Alias field such as my-new-site.com. A word of caution. When it comes to parent portals, the “my-new-site.com” domain name must already point correctly to your DNN install, otherwise the parent portal creation will fail. Most hosting providers support multiple domains pointing to a single IIS website at no additional cost.

Add New Portal

The Title, Description and Keywords fields are optional at this point. You can always enter these once the new portal is up and running. You do have to choose an install template though. For this discussion let’s go with the default DotNetNuke template. I’m currently working on a post that will shed some more light on DNN install templates and how to create your own.

Up next are the Security Settings. Pay attention in this section, because the user you specify here will be the initial administrator for the new portal. Once that’s done, click “Create Portal” and if everything goes well, a “fresh” DNN portal will appear. First thing you should do is log in with the admin account you just created. After logging in successfully, you can safely assume that your new parent portal is alive and well.

Do you have anything to add? Feel free to do so in the comments. And if you like this post, consider subscribing to my full feed RSS or get blog updates by email.




Comments

Vasilis Vasilis says:

A closer look into the installation templates will surely be very useful too! And not just for newbies :) Keep it up buddy!

Jeff Kershner Jeff Kershner says:

What does this mean:
When it comes to parent portals, the “my-new-site.com” domain name must already point correctly to your DNN install, otherwise the parent portal creation will fail. Most hosting providers support multiple domains pointing to a single IIS website at no additional cost.

Tom Kraak Tom Kraak says:

Jeff - that means that the “my-new-site.com” domain name must point to your hosting providers name servers and a DNS entry must be in place to point the domain name to your website ... all with the goal of reaching your DNN install via my-new-site.com.

Let me know if you have further questions.

Jeff Jeff says:

So my doing a nslookup for my domain name: doorywebsolutions.com, I see that it resolves to my hosting account. Looks like step 1 works...

You mentions that a DNS entry must be in place to point the domain name to my website. Well, when I create a parent portal in DNN, is my website the the install directory to my dotnetnuke (www.azlocals.com/dotnetnuke) or do I need to point it to a sub directory in that installation?

Thanks for your fast reply!

Tom Kraak Tom Kraak says:

Point all your domains to the root of your DNN install. DNN will sort it out from there.

Jeff Jeff says:

I have my www.doorywebsolutions.com mapped to my DNN installation directory (www.azlocals.com/dotnetnuke).

I created a parent portal for doorywebsolutions.

But when I visit www.doorywebsolutions.com, my browser just goes to www.azlocals.com/dotnetnuke.

What might I be doing wrong?

Dan Cernese Dan Cernese says:

same here!

Tom Kraak Tom Kraak says:

And you guys are sure that you added the domain name of your new parent portal as a DNN portal alias?

pucca pucca says:

how to point the alias(e.g. my-own-web.com) to your root(127.0.0.1) in XP? what file I need to update.
How to create a new portal template? Thank you so much.

Pucca

Tom Kraak Tom Kraak says:

Edit your Windows host file to tie my-own-web.com to 127.0.0.1. See mvps.org/winhelp2002/hostsfaq.htm for more info.

The default portal template (DotNetNuke.template) is located in \Portals\_default. So just open that file in a text editor, make your desired changes and "save as" your own template.

Let me know if I should blog more about that process.

pucca pucca says:

Tom,
thank you for the information. I have new in the setup the portal in DNN. here is what I tried for the portal alias:
1. go the hosts file enter one entry
127.0.0.1 my-own-site.com
2. go to IIS control to set up
2.1 a virtual directory to my-own-site.com and mape to the real directory
2.2 right click the directory, go to the property ->directory security tab ->authentification control -> browse -> andd IUser and ASPNET user
3. bring up the DNN ->host ->protal -> alias=my-own-site.com custom the directory to the directory I set in the IIS.
But it idoes not work. Can u tell me what is the problem?

Can you paste more detail information one the portal template part. I would like to set up couple options templates(beside dotnetnuke) when I create a new portal. Thank you So much.

pucca

Tom Kraak Tom Kraak says:

Pucca - did you ever resolve the above?

Club1Ten Club1Ten says:

I am trying to add a portal. I go through all of the steps as outlined above, but when I go to the new address, it defaults back to the primary portal. I can't find anywhere to access the new portal.

Tom Kraak Tom Kraak says:

Club1Ten - has the DNS been set up correctly, meaning “my-new-site.com” points to your DNN install?

Travis D. Falls Travis D. Falls says:

When you say set up your DNS, should I point the DNS at my folder for my parent portal, or for the DNN install? Meaning should I point my dns at the portal/01 dir?

Tom Kraak Tom Kraak says:

Travis - point the DNS to your DNN install ... DNN will sort it out from there.

Vengaboys Vengaboys says:

This blog post http://dnchannel.blogspot.com/2008/07/programmatically-creating-dotnetnuke.html shows how to create a portal programmatically using the DotNetNuke API.

Barry Barry says:

This does not work as advertised, and I cannot find a detailed, accurate, effective piece of documentation on this feature anywhere. It is quite frustrating.

Tom Kraak Tom Kraak says:

Barry - what exactly did you run into?

Barry Barry says:

I take that back! I actually just got it to work!

Barry Barry says:

Well, when I first set it up, i followed the advise in the top of this thread and it did not work. I just got a .NET application error, but then I realized that I had not set my new site to use .NET 2.0 in IIS. I tweaked this setting in IIS (I'm running Win Srvr 2003 Std ) and it worked.

Now, I have several sites running on the same dotnetnuke install.

URL1: www.enecms.com
URL2: beta.pauline.org

Both running on the exact same DNN install. Latest version, by the way, with SQL 2005 SP2

Tom Kraak Tom Kraak says:

Well done Barry and thanks for sharing.

Amrit Ray Amrit Ray says:

When you say update the DNS and point it to your DNN install, do you mean, 1. Change the name servers on the domain to your hosts name servers, and 2. create an alias for your new domain to your DNN install website?

The new domain surely needs physical hosting on the same server as your DNN install if you wish to create emails on your new domain.

Tom Kraak Tom Kraak says:

Amrit - that's exactly what I meant. Thanks for elaborating on it.

mark mark says:

RE: "...the “my-new-site.com” domain name must already point correctly to your DNN install..."

I wish to create a new portal from my DNN installation v. 04.05.05.

I want to start developing a parent site before it goes live - so I don't want to point it to the DNN install location just yet.

How can I get around this?

website:
www.sypensions.org.uk (this is the site to be revamped and pointed to DNN - but I don't want to point it to DNN webhost area until I have completed the site.)

When you say:
"it must already point correctly to your DNN install..."
do you mean point to it in IIS - creating a virtual directory?

thanks,
mark


mark mark says:

further to the above comment,

I have since reason to believe that I need to setup a host header in IIS to create another site...

but I'm still having problems.

My DNN installation is on a virtual directory called www.sypensions.org.uk/dnn (the first site is working ok), but I can't create another site.

When creating the host header - I can not right click on the name of the virtual directory (which is called dnn) - this is where my dotnetnuke installation points to.

I can only cretae a host header (in IIS 6) from right clicking on the level above (on sypensions.org.uk website).
New host Header called - 'development.sypensions.org.uk'

I then created a new portal and alias also: 'development.sypensions.org.uk'

When I visit www.development.sypensions.org.uk - I get an error:
"430 Not found, Unable to resolve name"

I also tried development.sypensions.org.uk/dnn as an alias, but this does not work either.

Any ideas?

regards,
mark.

Tom Kraak Tom Kraak says:

Add development.sypensions.org.uk to the same place where the sypensions.org.uk host header is specified.

mark mark says:

Thanks, I gave up on the host header method - as I couldn't get a new site created this way.

I am thinking that the problem could be due to our firewall perhaps? This mabe why I could only get DNN working in a subfolder of our internet in IIS.

The only way I could get a new site created was to create a new virtual directory in the same IIS subfolder as our original dotnetnuke site with the same path (not sure if this makes sense.)

I then created a new parent portal in DNN with the following address: www.sypensions.org.uk/development/ (our first DNN site was: www.sypensions.org.uk/dnn if you were thinking it looks like a child site).

Is there any reason why not to use virtual directories like this to create a new site?

mark.

apple17 apple17 says:

I have a site where my base install of DNN is at http://www.mysite.com/mydnnsite .

Now I want another portal at http://www.mysite.com/myNEWdnnsite using the same dnn install and database.

Seems to my that this is another PARENT site, but I don't know how to make this happen. Can you advise?

Thanks!

Jonathan Jonathan says:

We also have the same problem of parent aliases all returning the user to the main portal.

Could this have anything to do with our DNN instance being the main IIS website rather than a virtual directory?

Tom Kraak Tom Kraak says:

@ apple17 - did you try to follow the steps in the post above?

@ Jonathan - the process of creating DNN child / parent portals never requires any IIS involvement such as virtual directory creation.

jed jed says:

Hi tom,
I read your article and I have a question here, how to point the domain name to the DNN install?

Thanks,
Jed

Tom Kraak Tom Kraak says:

Jed - you point the domain name to the DNN install by mapping host header values to the website's IP address in IIS. That obviously assumes though that your DNS is set up properly (domain name pointing to your web server.)

I hope to have a screencast version of this blog post as soon as next week.

Tuff Tuff says:

Creating aliases with same domain works fine. Adding another domain name for a child portal only points to main portal. If I direct my new domain to the virtual directory of the child portal, the portal then gives an unrecoverable "Runtime Error" even if I remove the new domain. Help!!!

jmajor jmajor says:

Hi,

I'm still in the dark....sorry.

So, I have an original install of dnn at: www.web-site-ecommerce-consulting.com and logged in and made a parent portal and alias of www.wvosvo.com and wvosvo.com and went into my domain manager and pointed my Arecord to the IP address. When I type in www.wvosvo.com it resolves to: http://www.web-site-ecommerce-consulting.com/websitedesign/

What am I doing wrong?

Tom Kraak Tom Kraak says:

@ Jmajor - Besides configuring your DNS, you also need to go into IIS and add www.wvosvo.com and wvosvo.com as a host headers. If you do not have direct access to IIS, you should be able to do this via your hosting control panel or have your hosting provider do it for you.

Deep Deep says:

Hi Guys,

We are planning to launch one On Demand Portal Solution, based upon DNN 4.9 and the idea is to use multiple portals on single site. But i found one article scaring me to hell while doing this.

http://www.powerdnn.com/AtomicSLA/InformationCenter/tabid/333/ServiceID/3211/Default.aspx

I'm looking for your views and advices on how to mitigate these risks or what is the best way to handle this situation.

Thanx in Advance.

Regards,
Deep

Tom Kraak Tom Kraak says:

@ Deep - I do share some of the concern mentioned in the PowerDNN article in regards to multiple websites on one DNN installation.

What exactly do you have in mind for your "On Demand Portal Solution?"

Deep Deep says:

We have created one HR Portal [custom built app on top of DNN 4.9] and we would like to offer it On Demand model, means companies can just register online [we create a new portal] for trial and after one month if they like it, they pay the subscription and continue using the application. Our model is to offer the solution at low reccuring fee and if we have to setup new instance of DNN for every new free trial, the whole economics will go bit hay wire.

Not sure what is the good way of have the ease of automatic online setup and cost control.

regards,

Name (required)

Email (will not be published) (required)

Website

Enter the code shown above:

Subscribe to our Feeds Follow on Twitter