DotNetNuke 安裝指南(更新PDF下載)

DotNetNuke 安裝指南(更新PDF下載)

Charles Nurse

版本：1.0.03

最後更新：2005年11月28日

分類：安裝

翻譯：MasterLRC

下載:DotNetNuke安裝指南中文版下載（下載完成後擴展名改爲.pdf即可）

本文檔中的信息，包括 URL 和其他 Internet Web 站點參考，如有變更，恕不另行通知。使用此文檔的所有風險和使用此文檔造成的一切後果，由使用者本人承擔。

本文示例中的公司，組織，產品，域名，電子郵件地址，logo，人名，地名和事件描述存屬虛構。如有類同，存屬巧合

遵守任何適用的版權法是用戶的責任。在不限制版權所轄權利的前提下，未經Perpetual Motion Interactive Systems, Inc. 的明確書面許可，無論出於何種目的，均不得以任何形式或藉助任何手段（電子、機械、影印或其他手段）複製或傳播文擋中的任何部分，或將其存儲於或引入檢索系統。

Perpetual Motion Interactive Systems　可能擁有對本文檔內容的專利、專利申請、商標、版權或其他知識產權。除了任何Microsoft 授權許可協議所提供的明確書面許可，擁有本文檔並不賦予您任何有關這些專利、專利申請、商標、版權或其他知識產權的許可。

DotNetNuke. 和DotNetNuke logo 均系Perpetual Motion Interactive Systems 在美國及/或其他國家（或地區）的註冊商標。

其中提到的其他真實公司及產品名稱可能是其各自所有者的商標。

摘要

本文描述DotNetNuke 3.x版本和4.x版本的安裝過程

PAGEREF _Toc129077008 /h

DotNetNuke安裝指南.... 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100320039003000370037003000300039000000F3 PAGEREF _Toc129077010 /h

介紹... 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100320039003000370037003000310031000000F3 PAGEREF _Toc129077012 /h

設置你的站點，準備安裝... 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100320039003000370037003000310033000000F3 PAGEREF _Toc129077014 /h

升級到DotNetNuke3.x.. 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100320039003000370037003000310035000000F3 PAGEREF _Toc129077016 /h

準備升級... 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100320039003000370037003000310037000000F3 PAGEREF _Toc129077018 /h

安裝 DotNetNuke4.x.. 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100320039003000370037003000310039000000F3 PAGEREF _Toc129077020 /h

使用哪個安裝包？... 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100320039003000370037003000320031000000F3 PAGEREF _Toc129077022 /h

使用或安裝源碼包... 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100320039003000370037003000320033000000F3 PAGEREF _Toc129077024 /h

安裝DotNetNuke. 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100320039003000370037003000320035000000F3 PAGEREF _Toc129077026 /h

備份你的站點... 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100320039003000370037003000320037000000F3 PAGEREF _Toc129077028 /h

配置升級到4.x版本的web.config. 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100320039003000370037003000320039000000F3 PAGEREF _Toc129077030 /h

安裝可選資源和模塊.... 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100320039003000370037003000330031000000F3 PAGEREF _Toc129077032 /h

安裝附加資源... 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100320039003000370037003000330033000000F3 PAGEREF _Toc129077034 /h

錯誤：不能連接到connectionString中指定的SqlDataProvider數據庫(Could not connect to database specified in connectionString for SqlDataProvider.) 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100320039003000370037003000330035000000F3 PAGEREF _Toc129077036 /h

找不到存儲過程“dbo.GetPortals”（ Could not find stored procedure 'dbo.GetPortals'）... 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F006300310032003900300037003700300033003700000000 PAGEREF _Toc129077038 /h

模板示例... 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F006300310032003900300037003700300033003900000000 PAGEREF _Toc129077040 /h

錯誤和遺漏... 08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F006300310032003900300037003700300034003100000000 PAGEREF _Toc129077042 /h

² 安裝DotNetNuke3.x

² 將現有的安裝升級到DotNetNuke3.x

² 安裝DotNetNuke4.x

² 升級一個現有的3.x或4.x安裝

² 安裝/創建一個新的Portals

² 安裝資源

Ø 皮膚/容器

Ø 模塊

Ø 語言包

安裝特點

就安裝和升級而言，程序還有一些 “特徵”

² 自動升級－自動檢測是否需要安裝/升級，並自動安裝或升級

² 安裝模板－可以通過一個基於XML的模板來控制安裝，包括主機設置，模塊和Portals。

² DNNConfig文件－這個文件保存當前數據庫的版本，這樣可能避免每次App_Start時訪問數據庫

² 安裝日期－指定是否爲一次“新”的安裝自動生成“新”鍵

² 新安裝頁面（Install.aspx）－這個頁面在安裝/升級過程中顯示回饋信息

² 安裝文件夾－此文件夾通過批量FTP來管理在文件系統中新資源的定位，並且通過安裝包，批量安裝這些資源。

資源上傳－在Admin或Host有專門的UI組件來處理能被安裝的資源，在組件中有一個“Upload”按鈕行爲來啓動安裝。

DotNetNuke3.x安裝

在DotNetNuke3.x中，一個最大的改變就是對了安裝/升級的改進。在DotNetNuke的早期版本中，有一個自動升級功能檢測數據庫版本，將此版本信息與程序集版本進行比較，然後運行能將數據庫從當前版本升級到程序對應版本的腳本。

這樣在安裝和升級這間沒什麼本質的區別－區別僅在於執行的腳本的數量不同。例如，從2.1.1升級到2.1.2只需執行2.1.2的腳本，然而如果從2.0.1升級的話，就要執行五個腳本－2.0.2,2.0.3,2.0.4,2.1.1,2.1.2。一個2.1.2版本的全新安裝共需執行19個版本的腳本。

DotNetNuke3.x中修改了這一過程，全新安裝不必執行34個版本的腳本（如3.0.12），只需要執行2個腳本 DotNetNuke.Schema和DotNetNuke.Data。升級仍然執行剩餘腳本。

設置你的站點，準備安裝

如果你要安裝DotNetNuke的新實例，你第一步要做的，取決於你是在本地intranet上還是遠程服務器上創建站點。下面將描述整個過程。如果DotNetNuke被安裝在一個共享主機中，那麼主機的提供者可能已經爲你設置好了站點和數據庫。

1. 解壓打包文件

第一步將打包的文件解壓到程序運行的位置。從3.1版本開始，DotNetNuke有兩個包可用：

² DotNetNuke_X.Y.Z_Install.zip－安裝包－這個包裏包含ascx,aspx文件，同時包含其它內容文件和編譯後的程序集(dlls)，但是，包裏不包含VisaualBasic代碼文件。如果你不想修改核心文件，請使用這個安裝包。

² DotNetNuke_X.Y.Z_Source.zip－源碼包－裏面包含了核心DotNetNuke工程的所有相關文件，包括Visual Basic源文件。

（這裏X.Y.Z是版本號，例如：DotNetNuke_3.2.0_Install.zip）

雖然IIS（Internet Information Server）站點的默認位置是在 C:/Inetpub/wwwroot/...，但是如果在本地intranet上配置，你可以將站點放在任何位置（如：C:/DotNetNuke）。

如果在遠程主機上安裝DotNetNuke，你必須按照主機提供者指定的過程，將你的文件上傳到你的站點。

2. 配置IIS

在本地intranet上配置的話，在IIS中創建一個名爲DotNetNuke的虛擬目錄，指向物理路徑。在IIS6中右擊“默認站點”，選擇“新建->虛擬目錄”。

將啓動一個嚮導，指導你配置你的虛擬目錄。當你使用嚮導創建了虛擬目錄之後，你還可以通過在這個新虛擬目錄上右擊，選擇“屬性”，來編輯這個虛擬目錄的屬性。

3. 在SQLServer中創建數據庫

在遠程主機環境中，你的主機提供者可能已經爲你配置了SQL Server數據庫，並且爲你聯接到數據庫提供的指導。

如果在本地配置，你要創建一個新的數據庫。怎樣創建你的本地數據庫，要看你使用的數據庫工具是什麼。

在企業管理器（SQL Server2000）中，你可以通過在“數據庫”上右擊，並選擇“新建數據庫…”來創建一個新數據庫。

在“新數據庫”窗口輸入你的數據庫的名字（你可以輸入任意的名字，但默認名字是DotNetNuke），點擊“確定”。你也可能自己設置Collation名，併爲數據庫指定文件名，但是一般情況下這些屬性使用默認值就可以了。

下一步是爲你的DotNetNuke數據庫配置一個數據庫用戶。如果還沒有用戶，右擊“安全/登陸”

當你創建了登陸這後，在“用戶”（在你剛纔新建的DotNetNuke數據庫下）上右擊並選擇“新用戶”

在“新用戶”窗口的下拉列表中選擇你要使用的用戶帳號，並設置public和db_owner權限（事實上你不必設置完全的db_owner權限，後面的在web.config中配置data provider最小權限的章節中你將看到這一點）

這一過程在SQL Server Managerment Studio(SQL Server 2005)中更加簡單。右擊Databases並選擇“New Database”。

在“New Database”窗口中輸入數據庫名。

在“Security/Logins”右擊，創建一個新登陸。

在你新建的數據庫上右擊，爲你的新數據庫添加一個新用戶（在SQL Server Management Studio中，這位置是在你的數據庫的Security節點下）

確認設置了db_owner權限。

4. 設置文件權限

下一步是爲Asp.NET工作進程安裝DotNetNuke設置NTFS文件權限。這是因爲DotNetNuke需要創建路徑和文件。根據你的windows版本不同，你要設置權限的帳戶是不一樣的。

² 在 Windows2000/IIS5中的帳戶是(Server)/ASPNET帳戶，

² 在Windows2003/IIS5中的帳戶是NT AUTHORITY/NETWORK SERVICE帳戶

要設置權限，可以通過資源瀏覽器找到你在上面（1）中的物理文件夾，右擊這個文件夾選擇“屬性”，選擇“安全”標籤頁。

對於DotNetNuke下的各個文件夾的訪問權限，照下面設置：

Ø 根目錄（和所有子文件夾）－讀取

Ø 根目錄－寫入，修改（如果要安裝第三方提供的程序集）

Ø DesktopModules目錄－寫入，修改權限（允許文件管理器訪問皮膚/容器）

Ø 如果你還想安裝語言包，那麼你必須對根目錄下的所有子文件夾有寫入和修改權限

Ø Configuring web.config for Installation

爲安裝配置web.config文件

所有的ASP.NET應用程序都需要web.config文件。在3.1之前的版本中，這個文件包含在安裝包中。在3.1和後續版本中這個文件不在包含在安裝包中。如果你是安裝3.1或後續版本，你必須首先把release.config改名爲web.config

在你瀏覽並初始化安裝你的站點之前，你需要在web.config中進行一些設置。在<appSettings>設置組中，有5種設置來控制安裝/升級

</appSettings>

第一個設置(“SiteSqlServer”)定義程序使用的數據庫（例如：<add key="SiteSqlServer" value="Server=(local); Database=DotNetNuke; uid=;pwd=;" />）。使用你所用的數據庫的相應的值來替換Server,Databse,uid和password的值。如果是共享主機，主機提供者會提供這些值。在本機上安裝，你一般不需要修改Server的值。然而，在某些情況下，你可能需要把Server的值改成你的本地計算機名。

第二個設置（”InstallTemplate”）定義一個安裝模板。我們將在本文的後面詳細描述這個模板。這裏只是提示你一下，可以設置這塊內容來控制安裝選項。但默認的模板適用於絕大多數情況。

第三個設置（”Auto Upgrade”）指示是否自動執行安裝/升級過程。默認值爲true。不管怎麼設置DotNetNuke都將檢測當前的數據庫和程序集版本，如果版本不同，則重定向到安裝頁面。如果這一項設置爲true，那麼將自動執行安裝或升級處理。如果設置爲false，安裝頁面將報告版本差異，然後停止。

第四個設置（”UseDnnConfig”），默認值也是true，它指示DotNetNuke是否從/Install文件夾下的dnn.config文件中讀取當前數據庫版本。升級不能在每次Application Start的時候執行，使用這個文件能減少數據庫壓力，並提高性能。在安裝/升級結束時，當前的版本信息會寫入這個文件中。如果程序集的版本和這個文件記錄的版本相同，那就什麼也不做。如果不同，那麼自動升級(AutoUpgrade)將確認數據庫版本是否的確不同，並依此處理。

第五個設置(“InstallMemeberRole”)隨意安裝MemberRols provider腳本。由於這些腳本需要設置更高一級的工SQL　Server權限，可能一些主機提供者不允許運行這些腳本。如果他們不提供這種權限，那麼，在你安裝DotNetNuke這前，你要先要求主機提供者執行這些腳本。而且，如果和你其它使用MemberRole provider的程序（例如：Community Server）使用共享數據庫，那麼，如果其它程序已經安裝了，你就不必再重新運行這些腳本了。

Data Provider設置

有兩個非常重要的關於數據訪問的設置。下面是在web.config文件中定義data provider的部分

<add

name="SqlDataProvider"

type="DotNetNuke.Data.SqlDataProvider, DotNetNuke.SqlDataProvider"

connectionStringName="SiteSqlServer"upgradeConnectionString=""

providerPath="~/Providers/DataProviders/SqlDataProvider/"

objectQualifier=""

databaseOwner="dbo" />

</providers>

</data>

ObjectQualifier屬性用來控制數據庫中每個對象名的前綴。默認是空字符串””，因些，象”Portals”表創建爲”Portals”。舉例來講，如果把objectQualifier屬性設置成”dnn_”，那麼”Portals”表就會被創建成”dnn_Portals”，並且涉及Portals表的存儲過程也會使用”dnn_Portals”。建議設置這個屬性。因爲，DotNetNuke允許在同一環境中存在多個使用相同數據庫的應用程序。

DatabaseOwner屬性用於指定數據庫對象的“所有者”。默認情況下設置爲“dbo”，並且大多數據情況下應該保留這個值。然而，有一些SQL Server數據庫（尤其是共享主機環境）可以不允許用戶以以 db_owner權限認證聯接字符串。在這種情況下，把databaseOwner屬性置成你的登陸名。這個用戶至少應該具有下列SQL權限：

Ø db_datareader(dotnetnuke必須)

Ø db_datawriter(dotnetnuke必須)

Ø db_ddladmin(MemberRoles必須)

Ø db_securityadimin(MemberRoles安裝過程需要)

以上兩個設置僅與默認的MS SQL Server Data Provider相關。如果你使用其它data provider，你必須參照這個provider的文檔來作相應的配置。

Navigation Provider設置

在DotNetNuke3.2中，主要的導航系統爲抽象爲 Navigation Providers

<add name="SolpartMenuNavigationProvider"

type="DotNetNuke.NavigationControl.SolpartMenuNavigationProvider,

DotNetNuke.SolpartMenuNavigationProvider"

providerPath="~/Providers/NavigationProviders/SolpartMenuNavigationProvider/"/>

<add name="DNNMenuNavigationProvider"

type="DotNetNuke.NavigationControl.DNNMenuNavigationProvider,

DotNetNuke.DNNMenuNavigationProvider"

providerPath="~/Providers/NavigationProviders/DNNMenuNavigationProvider/"/>

<add name="DNNTreeNavigationProvider"

type="DotNetNuke.NavigationControl.DNNTreeNavigationProvider,

DotNetNuke.DNNTreeNavigationProvider"

providerPath="~/Providers/NavigationProviders/DNNTreeNavigationProvider/"/>

<add name="DNNDropDownNavigationProvider"

type="DotNetNuke.NavigationControl.DNNDropDownNavigationProvider,

DotNetNuke.DNNDropDownNavigationProvider"

providerPath="~/Providers/NavigationProviders/DNNDropDownNavigationProvider/"/>

</providers>

</navigationControl>

defaultProvider屬性默認設置爲 SolpartMenuNavigationProvider，但如果你要使用其它的provider，你只要把defaultProvider屬性設置成你想使用的provider的名字就可以了。

成員角色原型設置

在即將發佈（譯者翻譯時已經發布）的ASP.NET2.0(稱爲“Whidbey”)中，提供一種新的成員/角色provider機制，在web.config中有一系列的設置用來配置這個provider。在DotNetNuke3.0中包含這一機制的原型，但是DotNetNuke3.0僅支持修改四種參數：

<add name="DNNSQLMembershipProvider"

type="DotNetNuke.Security.Membership.DNNSQLMembershipProvider,

DNNSQLMembershipProvider"

connectionStringName="SiteSqlServer"

enablePasswordRetrieval="true"

enablePasswordReset="true"

requiresQuestionAndAnswer="false"

minRequiredPasswordLength="4"

minRequiredNonalphanumericCharacters="0"

requiresUniqueEmail="false"

passwordFormat="Encrypted"

applicationName="/"

description="Stores and retrieves membership data from the local Microsoft

SQL Server database" />

</providers>

</membership>

<roleManager

cacheRolesInCookie="true"

cookieName=".ASPXROLES"

cookieTimeout="30"

cookiePath="/"

cookieRequireSSL="false"

cookieSlidingExpiration="true"

createPersistentCookie="false"

cookieProtection="All">

<add name="DNNSQLRoleProvider"

type="DotNetNuke.Security.Role.DNNSQLRoleProvider, DNNSQLRoleProvider"

connectionStringName="SiteSqlServer"

applicationName="/"

description="Stores and retrieves roles data from the local Microsoft SQLServer database" />

</providers>

</roleManager>

<add name="AspNetSqlProvider"

type="DotNetNuke.Users.Profile.DNNSQLProfileProvider,

DNNSQLProfileProvider"

connectionStringName="SiteSqlServer"

applicationName="/"

description="Stores and retrieves profile data from the local Microsoft SQL Server database" />

</providers>

</properties>

</profile>

<anonymousIdentification

enabled="true"

cookieName=".ASPXANONYMOUS"

cookieTimeout="100000"

cookiePath="/"

cookieRequireSSL="false"

cookieSlidingExpiration="true"

cookieProtection="None"

domain="" />

</memberrolesprototype>

minRequiredPasswordLength-控制密碼的最小長度。Web.config中的默認配置是4，這是因爲一直一來默認的超級用戶使用host/host作爲用戶名和密碼。要增加默認值，需要修改安裝模板中位於<superuser>和<administrator>節點的的passwords provider。

minRequiredNonalphanumericCharacters-表示在密碼中要至少要包含多少個非字母字符。默認值爲0，因爲以前的DotNetNuke不要求非字母字符。同樣的，把這個屬性的值修改成任何正數時，要修改安裝模板中的的<superuser>和<administrator>。

cookieName-在provider的rolemanager和anonymouIndentification節都可以設置cookie的名字。可能沒必要設置，但是可以設置。

在.NET2.0下使用Medium Trust運行3.2版

雖然DotNetNuke3.2在ASP.NET1.1下編譯，但是它完全兼容.NET2.0。如果你或你的主機提供者沒有將站點配置爲Medium Trust，那麼你不必作任何不同設置，就可以使DotNetNuke2.0的絕大部分內容運行於.NET2.0這下。

如果DotNetNuke3.2以Medium Trust運行於.NET2.0，你需要在web.config的所有配置節中添加一個屬性設置，如下所示。如果在.NET1.1環境下運行，則不需要設置這個屬性（實際上會造成錯誤）

<section name="data" requirePermission="false"