We have worked hard with this module to produce a thorough manual. The .PDF version of the manual is included in the DotNetNuke Module Download Package found on our DNN module download page. The Pivot modules along with all our modules are available for free download and trial to all users who are registered on our site.
This is an extract of the install and IIS configuration steps.
The Advanced Login Module will install like any other DotNetNuke Manual. This module requires the following prerequisites:
· DNN 04.05.05 or later (for DNN 4 sites)
· DNN 05.00.1 or later (for DNN 5 sites)
The following videos will assist you if you are not familiar with installing a DotNetNuke Module.
Installing a Module in DNN 4
Installing a Module in DNN 5
This module is added to a DNN web page in the same method as any other DNN module.
1. Login as Host or Admin account.
2. Create a page or navigate to an existing page.
3. From the dropdown menu at the top of you DNN website, locate the iWebs – Pivot
4. Define the location of the module in the Pane selector, and add the module to the page.
Click the Add button or link, and you are done. The module is added to the page.
This module can either work in the browser using Silverlight 4. Or using the Microsoft Pivot Browser that is downloaded from http://www.getpivot.com
To enable the Silverlight application to run on your web server, you will need to enable Silverlight if you have not done so already.
Microsoft® SilverlightTM is a cross-browser, cross-platform plug-in for delivering the next generation of .NET based media experiences and rich interactive applications for the Web. Silverlight offers a flexible programming model that supports AJAX, VB, C#, Python, and Ruby, and integrates with existing Web applications. Silverlight supports fast, cost-effective delivery of high-quality video to all major browsers running on the Mac OS or Windows.
In most cases, hosters do not need to perform particular deployments to support Silverlight. However, check for the following basic items that could prevent Silverlight from functioning correctly.
Procedure
All MIME types needed to support Silverlight are implemented by default in Windows Server 2008 IIS 7.0 and Windows Vista SP1. Windows Vista RTM customers can add mime types by running ‘IIS Manager’, clicking on ‘Mime Types’, then clicking ‘add’ and adding the following mime types:
· .xap application/x-silverlight-app
· .xaml application/xaml+xml
· .xbap application/x-ms-xbap
Alternatively, you can add the following mime types to your %windir%\system32\inetsrv\config\applicationHost.config file in the <staticContent> section.
<mimeMap fileExtension=’.xaml’ mimeType=’application/xaml+xml’ /> <mimeMap fileExtension=’.xap’ mimeType=’application/x-silverlight-app’ /> <mimeMap fileExtension=’.xbap’ mimeType=’application/x-ms-xbap’ />
To enable IIS 6.0 in Windows Server 2003 or IIS7 in Windows Vista RTM with the appropriate MIME Types, add:
Here is a VBS script you could run to enable each of these types:
Const ADS_PROPERTY_UPDATE = 2 ‘ if WScript.Arguments.Count < 2 then WScript.Echo ‘Usage: ‘ + WScript.ScriptName + ‘ extension mimetype’ WScript.Quit end if ‘ ‘Get the mimemap object. Set MimeMapObj = GetObject(‘IIS://LocalHost/MimeMap’) ‘ ‘Get the mappings from the MimeMap property. aMimeMap = MimeMapObj.GetEx(‘MimeMap’) ‘ ‘ Add a new mapping. i = UBound(aMimeMap) + 1 Redim Preserve aMimeMap(i) Set aMimeMap(i) = CreateObject(‘MimeMap’) aMimeMap(i).Extension = WScript.Arguments(0) aMimeMap(i).MimeType = WScript.Arguments(1) MimeMapObj.PutEx ADS_PROPERTY_UPDATE, ‘MimeMap’, aMimeMap MimeMapObj.SetInfo ‘ WScript.Echo ‘MimeMap successfully added: ‘ WScript.Echo ‘ Extension: ‘ + WScript.Arguments(0) WScript.Echo ‘ Type: ‘ + WScript.Arguments(1)
If you copy and paste the code above into a VBS file and save it as ADDMIMETYPE.VBS the syntax to add each type would be:
ADDMIMETYPE.VBS .xap application/x-silverlight-app ADDMIMETYPE.VBS .xaml application/xaml+xmlADDMIMETYPE.VBS .xbap application/x-ms-xbap
1. Go to Start\Administrative Tools and run IIS Manager, see figure below:
2. Right click on the server name and select ‘Properties’, see figure below:
3. In the Properties Dialog, click on the ‘MIME Types’ button, see figure below:
4. In the ‘MIME Types’ Dialog, click the ‘New’ button, see figure below:
5. In the ‘MIME Type’ Dialog enter one MIME Type at the time:
see figure below:
For detailed information on Silverlight, visit http://silverlight.net/.
/Admin/SilverlightMIMEIISError/tabid/2337/language/en-US/Default.aspx
Normally we try to ensure that our module run using all standard DNN or recommended DNN configuration settings. In the case of this Pivot technology, we are limited to provide the technology that has come from the Microsoft Labs. Because DotNetNuke does not use the latest MVC technology, we must make some small changes in IIS to get the Pivot running.
The Application Pool that runs your DotNetNuke website needs to be set as “Integrated Mode” for the managed pipeline.
(the only mode in IIS6 and below) is a mode where IIS only works with ISAPI extensions and ISAPI filters directly. In fact, in this mode, ASP.NET is just an ISAPI extension (aspnet_isapi.dll) and an ISAPI filter (aspnet_filter.dll). IIS just treats ASP.NET as an external plugin implemented in ISAPI and works with it like a black box (and only when it's needs to give out the request to ASP.NET). In this mode, ASP.NET is not much different from PHP or other technologies for IIS.
, on the other hand, is a new mode in IIS7 where IIS pipeline is tightly integrated (i.e. is just the same) as ASP.NET request pipeline. ASP.NET can see every request it wants to and manipulate things along the way. ASP.NET is no longer treated as an external plugin. It's completely blended and integrated in IIS. In this mode, ASP.NET HttpModules basically have nearly as much power as an ISAPI filter would have had and ASP.NET HttpHandlers can have nearly equivalent capability as an ISAPI extension could have. In this mode, ASP.NET is basically a part of IIS.
1. Ensure you are running DNN 4.8 or greater if you want to run on IIS 7. (or in DNN 5x we suggest 5.4.2 or later)
2. Start IIS
3. Select Application Pools
4. Find the Application Pool for your website.
5. Double click the application pool, and ensure that Integrated is set in place of Classic
6. Ok and close.
7. Test your website and others, to ensure normal behaviour. Note the recommendations at point 1 for the versions.
If you are running II6 and wish to access the Microsoft Pivot Labs technology, you will need to enable some special configurations. To do this:
1. Login to your web server and start IIS
2. Browse to your Web Site or Virtual Directory for the website in question and Rick Click selecting Properties.
3. Select the Home Directory Tab / Configuration
4. On the Mappings Tab, select Add
5. The following data depends on what type of server you are running. 64 bit vs 32 bit, and if you have .net 4 installed or not. The only thing that changes is the path for the .dll file.
- Executable: C:\WINDOWS\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll Extension: .cxml Limit to: GET Script engine: checked Verify that file exists: unchecked this gives you something like this above. Click OK and repeat the process for the following extensions:
- Executable: C:\WINDOWS\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll Extension: .dzc Limit to: GET Script engine: checked Verify that file exists: unchecked
- Executable: C:\WINDOWS\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll
Extension: .dzi Limit to: GET Script engine: checked Verify that file exists: unchecked
Extension: .jpg Limit to: GET Script engine: checked Verify that file exists: unchecked
Not that the location of the four extensions described above will change, depending on your server status. As an example of the change for a 32 bit server without .Net 4 installed the location would change
C:\WINDOWS\Microsoft.NET\Framework64\v4.0.30319\
c:\windows\microsoft.net\framework\v2.0.50727\
So the location of the first file in the example above would be:
c:\windows\microsoft.net\framework\v2.0.50727\aspnet_isapi.dll still giving a setup that looks the same but with a different path
You can browse to your servers .net path (C:\WINDOWS\Microsoft.NET\Framework) to work out the location of the aspnet_isapi.dll file.