2.2.2 安装步骤

2.2.2  安装步骤

要安装DotNetNuke v3.x，请遵循下述步骤(后续章节将对这些步骤进行详细解释)。

① 下载软件。
② 解压缩安装包。
③ 在SQL Server中创建数据库。
④ 创建数据库登录。
⑤ 设置文件权限。
⑥ 配置IIS(Internet信息服务器)。
⑦ 为安装配置web.config。
⑧ 执行安装。

第1步：下载软件

从DotNetNuke的官方网站(www.dotnetnuke.com)下载最新版本的DotNetNuke软件，如图2-1所示。
只有注册用户才可以下载该软件。注册过程相当简单—— 只需选择网页中的Register链接，然后遵照提示操作即可。

图2-1  下载软件

选择适合自己的DotNetNuke 3.x安装包。

● Install安装包(DotNetNuke_X.Y.Z_Install.zip)：只包含运行应用程序所需的文件。如果不希望对核心文件做任何修改，就可以使用这个安装包。

● Source安装包(DotNetNuke_X.Y.Z_Source.zip)：包含与核心DotNetNuke项目相关的所有文件，包括所有的Visual Basic源代码文件。如果希望修改核心文件或者希望查看相关源代码，则需要使用这个安装包。

第2步：解压缩安装包

将zip文件中的全部内容解压缩到所选的安装目录。对于本地企业内网中的安装操作，可以将网站置于任何位置(例如：c:\Websites\dotnetnuke\)。而对于远程宿主服务器安装操作，则需要遵循宿主提供商的规程将文件上传到网站上。

对于zip文件的解压缩，可以使用Windows XP内置的zip功能，或者使用第三方的压缩工具，例如WinZip(可以从www.winzip.com网站上下载)。

第3步：在SQL Server中创建数据库

创建包含DotNetNuke应用程序数据的数据库。

在远程宿主环境中，宿主提供商可能已经配置好了SQL Server数据库，这时只需按照提示连接数据库即可。

对于本地企业内网中的安装，则需要手动创建一个新的数据库。要在SQL Server 2000中创建数据库，前提是已经安装了Enterprise Manager(企业管理器)和Microsoft SQL Server Client Tools(Microsoft SQL Server客户端工具)。如果还没有安装这些工具，则可以从Microsoft SQL Server的安装光盘中安装这些工具。

打开Enterprise Manager，然后展开希望创建数据库的数据库服务器。如果数据库服务器还没有被列出来，则需要在Enterprise Manager中注册SQL Server实例。关于这一步，请参见Enterprise Manager的相关帮助。

既然已经发现了数据库服务器—— 对于本地企业内网中的安装，数据库服务器就是被称为(local)的本地计算机—— 通过右击服务器下面的Databases节点，然后选择New Database来创建新的数据库，如图2-2所示。

图2-2  创建新的数据库

接着弹出一个对话框，询问数据库的名称。输入希望的数据库名称，然后单击OK按钮。在本例中，使用DotNetNuke作为数据库的名称，如图2-3所示。

在Data Files和Transaction Log对话框中还有进一步的配置选项，但是对于本次安装，只需接受默认值即可。关于这些选项的更多详细信息，请参见Enterprise Manager附带的帮助文件。

图2-3  输入数据库名称

第4步：创建数据库登录

严格地讲，在创建访问数据库的用户账户时有两种选择。

● Windows Security：使用运行应用程序的Windows账户访问数据库。(这种方式具有更多的安全选项，但并不是所有的环境都支持这种方式，特别是共享宿主的情况。)

● SQL Server Security：使用用户名和密码组合的方式来访问数据库。

本书将使用SQL Server Security安全方式，但我们鼓励大家使用Windows Security安全方式，特别是在企业内网环境中安装DotNetNuke时。

要在Enterprise Manager中为数据库创建一个用户账户，首先需要定位到位于所连接服务器顶层的Security节点。然后展开它并选择Logins节点。这时在右边的面板中就会显示目前可以访问数据库服务器的用户列表。
右击Logins节点，然后选择New Login命令(如图2-4所示)。

图2-4  选择New Login命令

图2-5  详细信息

如果无法选择SQL Server身份验证方式，则需要确保数据库运行在Mixed Mode访问模式下，这种模式可以通过数据库的Properties对话框配置。

在单击OK按钮之前，还有一步要做。尽管已经选择将DotNetNuke作为默认数据库，但还需要授予新用户对这个数据库的Read和Write访问权利。为此，请选择Database Access选项卡，然后选择紧挨着DotNetNuke数据库的Permit复选框。在这个选项卡底部的Database Roles列表中，选择db_owner特权的Permit复选框，因为用户必须能够创建和删除数据库对象。

图2-6示范了正确的设置。设置完这些内容之后，单击OK按钮，根据提示再输入一次确认密码，然后再次单击OK按钮。

图2-6  进一步配置

现在只要选择Logins节点，新的账户就会出现在右边的面板上。对于这个账户，在任何时候都可以回到此处，对它的相关信息进行修改。

第5步：设置文件权限

ASP.NET的工作进程要求设置NTFS(文件)权限，以使DotNetNuke能为高级功能(例如文件管理器、多门户网站创建等)创建目录和文件。

另外，用户账户还需要根据所运行Windows的版本设置额外的权限。

● Windows 2000/Windows XP Professional(IIS5)：{Server}\ASPNET用户账户。
● Windows 2003(IIS6)：NT AUTHORITY\NETWORK SERVICE用户账户。

为了设置正确的文件权限，需要打开File Explorer，定位到安装DotNetNuke的文件夹(例如C:\Websites\DotNetNuke\)。右击该文件夹，选择Properties命令，然后再选择Security选项卡(如图2-7所示)。

图2-7  Security选项卡

如果看不到Security选项卡，则需要取消Simple File Sharing选项。具体操作步骤如下所示。

● 选择Start | My Computer | Tools | Folder Options | View。
● 滚动到高级设置列表的底部，取消Use Simple File Sharing (Recommended)项的选择。
● 单击OK按钮。

文件夹的最低权限要求如下所示。

● 根文件夹(及所有的子文件夹)：读取和写入访问权限
● /DesktopModules文件夹：写入和修改访问权限
● /Portals(及所有的子文件夹)：写入和修改访问权限

如果需要创建子门户网站或者安装额外的语言包，则需要设置另外一种权限。

根文件夹(及所有的子文件夹)：读取、写入和修改访问权限。

第6步：配置IIS(Internet信息服务器)

安装DotNetNuke v3.x的下一步就是创建一个指向DotNetNuke安装文件的新网站。为了配置Web服务器，需要使用IIS管理控制台。

为了运行管理控制台，可以选择Start | Run，输入inetmgr命令，然后单击OK按钮。

另外，还可以通过Windows的Control Panel访问管理控制台，即在Control Panel中选择Administrative Tools | Internet Information Services。

此时就会弹出IIS的管理控制台，显示一个含有本地计算机名称的节点。展开这个节点就会显示出本地计算机上的网站列表。展开Default Web Site节点。图2-8显示了IIS安装时自动配置的默认网站。

如果IIS不在本地计算机上，那么可以通过右击Internet Information Services节点，选择Connect，然后遵照屏幕提示连接到远程计算机上来远程管理IIS。

图2-8  默认网站

图2-9  创建向导

图2-10  输入虚拟目录的名称

图2-11  选择目录

单击Next按钮。

最后一步是指定虚拟目录的权限。保留默认的Read和Run Scripts权限，单击Next按钮，然后单击Finish按钮。图2-12显示了访问权限的正确设置。

图2-12  正确设置

这时就完成了IIS的配置，可以关闭管理控制台了。

第7步：为安装配置web.config

所有的ASP.NET应用程序都需要一个称为web.config的核心配置文件。这个文件用来存储与应用程序相关的设置，例如数据库连接和加密字符串。

默认情况下，DotNetNuke并没有提供这个配置文件。相反，却包含了release.config和development.config两个文件，这两个文件针对不同的环境、产品或者开发分别进行了相应的优化。

对于本例中的安装，可以使用release.config文件，即将它重命名为web.config即可。在重命名了这个文件之后，就可以在自己喜欢的文本编辑器中打开这个文件。

web.config文件包含了许多设置，其中一些设置需要自己调整。在<appSettings>代码段中有5个设置项控制着DotNetNuke的安装和升级。程序清单2-1以粗体形式列出了该代码段中控制安装的设置项。

程序清单2-1  <appSettings>代码段

<appSettings>
<add key="SiteSqlServer" value="Server
=(local);Database=DotNetNuke;uid=;pwd=;" />
<add key="MachineValidationKey"
value="F9D1A2D3E1D3E2F7B3D9F90FF3965ABDAC304902" />
<add key="MachineDecryptionKey"
value="F9D1A2D3E1D3E2F7B3D9F90FF3965ABDAC304902F8D923AC" />
<add key="MachineValidationMode" value="SHA1" />
<add key="InstallTemplate" value="DotNetNuke.install.resources" />
<add key="AutoUpgrade" value="true" />
<add key="UseDnnConfig" value="true"/>
<add key="InstallMemberRole" value="true" />
<!-- Show missing translation keys (for development use) -->
<add key="ShowMissingKeys" value="false" />
<add key="EnableWebFarmSupport" value="false" />
<add key="EnableCachePersistence" value="false" />
</appSettings>

下面对这些设置项进行详细说明。

● SiteSqlServer：该节点包含了数据库的连接字符串。改变该节点中相应的属性来指定所用数据库的服务器(server)、名称(name)、用户名(username)和密码(password)。下面是一个SQL Server 2000连接字符串的例子。

<add key="SiteSqlServer" value="Server=(local);Database=DotNetNuke; 
uid= DotNetNukeUser;pwd=DotNetNukeUser;" />

● InstallTemplate：该设置指向一个XML文件，允许对安装过程进行额外的控制。通过定制这个文件，管理员就可以修改默认的安全账户、主机设置以及要创建的门户网站。除非您是一个高级用户，否则就不要改变这个文件，保留默认设置即可。

● AutoUpgrade：该设置决定在发现版本差异时是否自动运行安装/升级过程。如果将该项设置为true，那么在任何时间，只要DotNetNuke判断当前正在运行的代码比数据库的版本高，DotNetNuke就会自动地执行安装或者升级过程。如果将该项设置为false，那么DotNetNuke在发现版本不同时就会报告版本差异，然后停止。该项的默认设置为true。仅当您希望通过定位到(http://{siteURL}/Install/Install.aspx)手动启动安装过程时，才可以将该项设置为false。

● UseDnnConfig：在安装或者升级过程中比较程序集的版本和数据库的版本时，该设置用来确定DotNetNuke完成这项比较的方式。为了防止对数据库的多次访问，安装文件夹中缓存了一个称为dnn.config的文件；该文件包含当前数据库架构的版本号。该设置用来决定DotNetNuke是检查这个文件还是直接访问数据库。出于性能方面的考虑，该设置的默认值设为true，以适应大多数情况。

● InstallMemberRole：该设置可以控制随DotNetNuke一起打包的成员角色脚本的安装。这些脚本初始化用来集中存储用户和角色信息的表格和存储过程。这些脚本需要更高级别的数据库权限(数据库的owner权限)，并且还可能需要通过另一个安全账户进行初始化(预安装)。该设置的默认值为true。仅当用户希望手动安装这些脚本时，才可以将其设置为false。

web.config文件后面还定义了一段有关数据提供程序的设置(参见程序清单2-2)。在默认的SQL Server提供程序中有两个选项可能需要定制。这两个选项在程序清单中以粗体显示。
程序清单2-2  数据提供程序段

<data defaultProvider="SqlDataProvider">
<providers>
<clear />
<add name="SqlDataProvider"
type="DotNetNuke.Data.SqlDataProvider, DotNetNuke.SqlDataProvider"
connectionStringName="SiteSqlServer"
upgradeConnectionString=""
providerPath="~\Providers\DataProviders\SqlDataProvider\"
objectQualifier=""
databaseOwner="dbo" />
</providers>
</data>  

下面对这些设置项进行详细说明。

● objectQualifier：该设置可以为数据库中所创建的任何对象设置一个前缀。举例来讲，如果将对象的限定符指定为dnn_，那么users表将被创建成dnn_users。如果多个应用程序可能需要使用同一个数据库，那么建议大家指定这一设置。

● databaseOwner：该设置指定哪个数据库用户拥有DotNetNuke在数据库中创建的对象。默认情况下，这个用户被设置为数据库的拥有者(dbo)，并且在大多数情况下应该保留这个设置。
但在一些情况下，数据库的所有者可能并不将数据库的所有者(db_owner)权利授予我们(例如第三方宿主)。在这些情况下，可以将databaseOwner属性设为自己用户账户的标识。如果这个用户账户不是数据库所有者，那么这个用户必须至少拥有下述权限。

● db_datareader(DotNetNuke必需的)
● db_datawriter(DotNetNuke必需的)
● db_ddladmin(MemberRoles必需的)
● db_securityadmin(MemberRoles安装过程中必需的)

第8步：执行安装

在进行安装之前首先验证已经完成了上述所有7个步骤。
① 从http://www.dotnetnuke.com网站上获取最新的源代码。
② 将最新的源代码解压缩到一个本地文件目录中。
③ 为应用程序创建一个新数据库。
④ 创建一个用来连接数据库的新用户。
⑤ 设置本地文件目录的文件权限。
⑥ 在IIS中创建一个新的虚拟目录。
⑦ 在web.config文件中配置与应用程序相关的项(例如数据库连接等)。

如果已经完成了所有上述步骤，就可以打开Web浏览器，对于本地安装可以浏览http://localhost/dotnetnuke/页面，而对于远程安装可以浏览http://www.mydomain.com/页面。

AutoUpgrade功能(详见第7步中的讨论)用于检测数据库是否为空。如果AutoUpgrade被设置为false，那么浏览网站时就会出现一个Site Unavailable页面(如图2-13所示)提示网站不可用。然后管理员可以使用下述URL之一来激活安装。

● 本地安装—— http://localhost/dotnetnuke/Install/Install.aspx?mode=Install
● 远程安装—— http://www.mydomain.com/Install/Install.aspx?mode=Install

图2-13  提示信息

图2-14  自动安装

安装过程在页面上记录了大量的事件。下面来看看都发生了什么。

① 安装程序报告正在被安装的模板的版本(Installing Version: 3.1.0)。
② 安装程序报告SQL安装脚本开始执行。

● DotNetNuke.Setup.SqlDataProvider
● DotNetNuke.Schema.SqlDataProvider
● DotNetNuke.Data.SqlDataProvider

③ 安装程序报告SQL公共脚本开始执行。

● InstallCommon.sql
● InstallMembership.sql
● InstallProfile.sql
● InstallRoles.sql

④ 安装程序报告SQL脚本开始执行增量式升级(Upgrading to version: 3.1.1、Upgrading to version: 3.2.0等)。

⑤ 解析Install模板各节内容。

● Host Settings
● SuperUser

⑥ 模板安装完毕。

⑦ 门户网站创建完毕。

⑧ 安装可选资源，例如额外的皮肤、容器等。

安装完成之后，单击Click Here To Access Your Portal链接就可以访问新的DotNetNuke站点。