DotNetNuke v4 on ASP.NET DotNetNuke v4 on ASP.NET v2v2

Stan SchultesStan Schultes Enterprise architect / application developerEnterprise architect / application developer Conference speaker, mentor, trainerConference speaker, mentor, trainer Contributing Editor, Visual Studio MagazineContributing Editor, Visual Studio Magazine Microsoft MVPMicrosoft MVP www.vbnetexpert.comwww.vbnetexpert.com stan@vbnetexpert.comstan@vbnetexpert.com

WebCast Series on WebCast Series on DotNetNukeDotNetNuke

2005 WebCasts:2005 WebCasts:Jan 31: Jan 31: DNN v3 – Overview DNN v3 – Overview Jan 31: Jan 31: DNN v3 – Installation and ConfigurationDNN v3 – Installation and ConfigurationFeb 4:Feb 4: DNN v3 – Portal ManagementDNN v3 – Portal ManagementFeb 4:Feb 4: DNN v3 – Custom Module DevelopmentDNN v3 – Custom Module DevelopmentMay 16:May 16: DNN v3 – Building Custom ModulesDNN v3 – Building Custom ModulesMay 16:May 16: DNN v3 – Advanced Module DevelopmentDNN v3 – Advanced Module Development

2006 WebCasts:2006 WebCasts:Feb 13:Feb 13: DNN v4 – OverviewDNN v4 – OverviewFeb 13: Feb 13: DNN v4 – Running on ASP.NET v2DNN v4 – Running on ASP.NET v2

http://msdn.microsoft.com/webcastshttp://msdn.microsoft.com/webcastshttp://www.vbnetexpert.com (DotNetNuke downloads)http://www.vbnetexpert.com (DotNetNuke downloads)

Presentation OutlinePresentation Outline DNN v4 – Get Running on ASP.NET v2DNN v4 – Get Running on ASP.NET v2

Installation Requirements Installation Requirements Distribution PackagesDistribution Packages Installation Walkthrough, Tips & TricksInstallation Walkthrough, Tips & Tricks Deploying DNNDeploying DNN Upgrading DNNUpgrading DNN

What’s New in ASP.NET v2?What’s New in ASP.NET v2? Developing for DNN v4Developing for DNN v4

Starter KitStarter Kit Source DistributionSource Distribution

Tips & TricksTips & Tricks

DNN v4 Installation DNN v4 Installation RequirementsRequirements

Win2K, WinXP, or Win2K3 with IIS & SMTPWin2K, WinXP, or Win2K3 with IIS & SMTP DNN v3.2:DNN v3.2:

.NET FW v1.1, SQL 2000 / MSDE.NET FW v1.1, SQL 2000 / MSDE Visual Studio 2003 for developmentVisual Studio 2003 for development

DNN v4.0:DNN v4.0: .NET FW v2.0, SQL 2005 / Express (or SQL 2000).NET FW v2.0, SQL 2005 / Express (or SQL 2000) Visual Studio 2005 for developmentVisual Studio 2005 for development

Package Distribution Package Distribution OptionsOptions

Install vs. Source Install vs. Source Install package – upgrades from v3 to v4Install package – upgrades from v3 to v4 Source package – no auto upgrade pathSource package – no auto upgrade path

Starter KitStarter Kit Separate Docs Download (PDF)Separate Docs Download (PDF) Installation templatesInstallation templates Modules Separate from CoreModules Separate from Core

Place desired modules in Install directoryPlace desired modules in Install directory

DNN v4 Installation DNN v4 Installation WalkthroughWalkthrough

Unzip the Install package to a directory Unzip the Install package to a directory Set directory permissions (ASPNET/Network Service)Set directory permissions (ASPNET/Network Service) Create empty SQL database, create account as Create empty SQL database, create account as

db_owner db_owner Create virtual web directory, configure for ASP.NET v2Create virtual web directory, configure for ASP.NET v2 Rename release.config to web.configRename release.config to web.config Edit web.config Edit web.config

DB connection stringsDB connection strings MachineKeysMachineKeys custom settingscustom settings

Browse to http://localhost/vdir - automatically sets up Browse to http://localhost/vdir - automatically sets up sitesite

Change Host and Admin passwords!Change Host and Admin passwords!

Installation Tips & TricksInstallation Tips & Tricks

Read the Installation Guide!Read the Installation Guide! Setup guides: \documentation\*.htmlSetup guides: \documentation\*.html

Site Builder Wizard – rehydrate from templateSite Builder Wizard – rehydrate from template Import Module contentImport Module content

Bulk resource install directories: Bulk resource install directories: Container, Language, Module, Portal, Skin, TemplateContainer, Language, Module, Portal, Skin, Template

Exception log in \portals\_default\logsException log in \portals\_default\logs Installation failures: try delete & re-create DBInstallation failures: try delete & re-create DB Watch DNN forums & bug tracker for fixesWatch DNN forums & bug tracker for fixes

Deploying Your PortalDeploying Your Portal Local vs. hosted installLocal vs. hosted install

Ideally: your web host supports DNN auto installIdeally: your web host supports DNN auto install Reality: build a local staging site firstReality: build a local staging site first Object: install only runtime files on hosted siteObject: install only runtime files on hosted site Upgrades: rehearse on your staging site first!Upgrades: rehearse on your staging site first!

Shared hosting / databases Shared hosting / databases use objectQualifier (any unique string) in web.config for use objectQualifier (any unique string) in web.config for

shared DBsshared DBs Set AutoUpgrade setting in web.config to False while Set AutoUpgrade setting in web.config to False while

configuring siteconfiguring site Browse to: <url>/install/install.aspx?mode=installBrowse to: <url>/install/install.aspx?mode=install

Running in Medium Trust environments Running in Medium Trust environments add requirePermissions=“False” to all config sections add requirePermissions=“False” to all config sections see Code Access Security (CAS) docsee Code Access Security (CAS) doc

Use portal templates & module exports to deploy contentUse portal templates & module exports to deploy content Think through (& test!) your backup / restore processThink through (& test!) your backup / restore process

Upgrading DotNetNukeUpgrading DotNetNuke

Source package: no auto upgrade from DNN v3 to Source package: no auto upgrade from DNN v3 to v4v4 Project models & directory structures are differentProject models & directory structures are different

Back up current configuration, database, Back up current configuration, database, web.configweb.config

Unzip the new install package into portal directoryUnzip the new install package into portal directory Configure new web.configConfigure new web.config

DB connection strings, MachineKeys, custom settingsDB connection strings, MachineKeys, custom settings Browse to the siteBrowse to the site Obsolete files are automatically deletedObsolete files are automatically deleted

(\portals\_default\<ver>.txt)(\portals\_default\<ver>.txt) Rehearse the upgrade on your staging siteRehearse the upgrade on your staging site

What’s New in ASP.NET v2?What’s New in ASP.NET v2?

Client API EnhancementsClient API Enhancements New Client Script Manager classNew Client Script Manager class

Navigation Controls use the Provider modelNavigation Controls use the Provider model Windows Authentication (Admin -> Windows Authentication (Admin ->

Authentication)Authentication) New ConfigurationManager class for web.config New ConfigurationManager class for web.config Changes in handling of XSL Transforms Changes in handling of XSL Transforms CBO class updated to support Generics CBO class updated to support Generics

return <List of T> rather than ArrayListreturn <List of T> rather than ArrayList Code rewrites for deprecated classes/methodsCode rewrites for deprecated classes/methods

Developing for DNN v4Developing for DNN v4 Starter Kit with Visual Web Developer (VWD)Starter Kit with Visual Web Developer (VWD) Visual Studio 2005 & SQL Server 2005Visual Studio 2005 & SQL Server 2005

Project directory structure changes dramaticallyProject directory structure changes dramatically Provider model used throughoutProvider model used throughout Core & standard modules are written in VBCore & standard modules are written in VB

Develop custom modules with any .NET languageDevelop custom modules with any .NET language Custom Module migration Custom Module migration

Test - v3 modules should run on FW v2.0Test - v3 modules should run on FW v2.0 Convert to ASP.NET v2 controls, upgrade 3Convert to ASP.NET v2 controls, upgrade 3rdrd party party

Use IIS vs. built-in Cassini web serverUse IIS vs. built-in Cassini web server

DNN v4 – Tips & TricksDNN v4 – Tips & Tricks

DNN Forums are your friendDNN Forums are your friend Watch your Log Viewer for errorsWatch your Log Viewer for errors Manage your database sizeManage your database size

Dev machine: set DB recovery mode to Dev machine: set DB recovery mode to SimpleSimple

Build a sitemap for search enginesBuild a sitemap for search engines Build a staging site for upgrades (VPC), Build a staging site for upgrades (VPC),

always back up before attemptingalways back up before attempting See \docs dir, DNN documentation (PDF)See \docs dir, DNN documentation (PDF)

Learn MoreLearn More www.dotnetnuke.com - project download (register) and infowww.dotnetnuke.com - project download (register) and info support.dotnetnuke.com - Gemini bug trackersupport.dotnetnuke.com - Gemini bug tracker http://forums.asp.net/90/ShowForum.aspx - DNN main forumhttp://forums.asp.net/90/ShowForum.aspx - DNN main forum http://www.dotnetnuke.com/default.aspx?tabid=795http://www.dotnetnuke.com/default.aspx?tabid=795 - full DNN forums list- full DNN forums list http://forums.asp.net/1107734/ShowPost.aspx - DNN 3.2 and 4.0 (pinned post)http://forums.asp.net/1107734/ShowPost.aspx - DNN 3.2 and 4.0 (pinned post) http://forums.asp.net/1114393/ShowPost.aspx - DNN v4 starter kits & templateshttp://forums.asp.net/1114393/ShowPost.aspx - DNN v4 starter kits & templates http://forums.asp.net/1105076/ShowPost.aspx - starter kits forum threadhttp://forums.asp.net/1105076/ShowPost.aspx - starter kits forum thread http://forums.asp.net/1123229/ShowPost.aspx - installing DNN v4 sourcehttp://forums.asp.net/1123229/ShowPost.aspx - installing DNN v4 source http://www.adefwebserver.com/DotNetNukeHELP/DNN_Module4/ - DNN v4 module http://www.adefwebserver.com/DotNetNukeHELP/DNN_Module4/ - DNN v4 module

development tutorialdevelopment tutorial http://forums.asp.net/1156381/ShowPost.aspx - discussion of web application http://forums.asp.net/1156381/ShowPost.aspx - discussion of web application

projectsprojects http://msdn.microsoft.com/msdnmag/issues/06/01/ExtremeASPNET/ - explains http://msdn.microsoft.com/msdnmag/issues/06/01/ExtremeASPNET/ - explains

ASP.NET v2 codebehind modelASP.NET v2 codebehind model http://weblogs.asp.net/bsimser/archive/2006/01/31/437023.aspx - DNN vs. http://weblogs.asp.net/bsimser/archive/2006/01/31/437023.aspx - DNN vs.

Sharepoint discussionSharepoint discussion http://sourceforge.net/projects/goog-sitemapgen/ - Google sitemap generatorhttp://sourceforge.net/projects/goog-sitemapgen/ - Google sitemap generator www.asp.net - Microsoft’s ASP developer sitewww.asp.net - Microsoft’s ASP developer site www.codeproject.com/database/ConfigureMSDE.asp?print=truewww.codeproject.com/database/ConfigureMSDE.asp?print=true