DNN Tips & Tricks #8: How to customize the DotNetNuke Installation

Dec 9

Written by: Joe Brinkman
12/9/2008 12:31 AM  RssIcon

DotNetNuke 3.0 added a lot of new capabilities.  One of the little documented features was the ability to control how DotNetNuke is installed.  Over the last 4 years the installation capabilities have been expanded.  One of the features which was added was the ability to control the Host Settings during the installation process.

When performing a new install using the install wizard, you have three options: Auto, Typical and Custom.  If you perform an Auto install, it uses the web.config and installation templates to determine the settings to use during the install. You can also perform an auto install by using the ~/install/install.aspx?mode=install page.

DNNWizard

To customize your auto-install, modify the DotNetNuke.install.config template located in the Install directory.  As you see below, this template gives you granular control over the settings used to configure the default install.


    This is the default DotNetNuke Host Installation Template
    
        
        
    
    05.00.00
    
        SuperUser
        Account
        host
        dnnhost
        host
        en-US
        0
    
    
        4
        10
        Y
        Admin/ControlPanel/IconBar.ascx
        Y
        
        N
        Y
        Y
        Y
        N
        
        N
        swf,jpg,jpeg,jpe,gif,bmp,png,doc,xls,ppt,pdf,txt,xml,xsl,css,zip
        http://www.dotnetnuke.com/default.aspx?tabid=787
        USD
        
        
        0
        
        DotNetNuke
        http://www.dotnetnuke.com
        0
        0
        D
        Y
        
        P
        PayPal
        3
        
        
        
        
        
        
        2
        1
        0
        D
        G
        
        N
        
        
        
        Y
        Y
        
        20
        
        N
    
    
    
        
            My Website
            
                Administrator
                Account
                admin
                dnnadmin
                
            
            My Website
            DotNetNuke, DNN, Content, Management, CMS
            DotNetNuke.template
            
                
            
            false
        
    

By creating your own custom template and dropping it in your Install directory prior to installation, you can have greater control over the install process and actually speed up your install since you won’t need to step through the wizard.  Many of the settings exposed by the installation template are not available from the Installation Wizard screens.  You can still use the Wizard with a custom template. Just remember that if you run an auto installation you will need to manually edit your database connection string in the web.config, unless you plan to use the included SQL Express database.

3 comment(s) so far...


Gravatar

re: DNN Tips & Tricks #8: How to customize the DotNetNuke Installation

You just gave me an AWESOME idea for a customization application.... Thanks for the great post!

By Mitchel Sellers on   12/9/2008 11:25 AM
Gravatar

re: DNN Tips & Tricks #8: How to customize the DotNetNuke Installation

I was once in a 72+ DNN instance environment, and this feature helped immensely. Properly used, it can save many hours of work. Planning is essential.

By Will Strohl on   12/9/2008 11:27 AM
Gravatar

re: DNN Tips & Tricks #8: How to customize the DotNetNuke Installation

@Will - This feature was specifically added for hosters to be able to customize installations. Glad to hear that you found it useful.

By jbrinkman on   12/9/2008 3:42 PM
dummy