.NET 平台下WEB 应用程序的部署( 安装数据库和自动配置)
李洪根
在 .NET 平台下,部署 Web 解决方案是比较方便的。我们可以利用 Visual Studio.NET 2003 添加一个 WEB 安装项目,在部署的“文件系统编辑器”中添加项目的主输出和内容文件,非常简易地完成安装程序的制作。
但是,这样制作的安装程序,只是将 Web 页和 ASP.NET 程序编译的 DLL 文件安装到目标机器的 IIS 目录,对于一般的应用程序是可以的(比如用 Access 数据库,可以一起打包到安装程序中);如果数据库是 SQL SERVER ,需要在部署的时候一并安装数据库,安装程序的制作就会复杂一些,需要我们自定义安装程序类。在安装程序类中执行 SQL 脚本并将连接字符串写入 Web.config 。
l 安装数据库
微软 MSDN 上介绍过在部署应用程序的时候建立数据库。如:
这种方法是创建一个安装程序类,在安装程序类中调用 ADO.NET 执行 SQL 语句( SQL 语句放在一个文本文件中)来创建数据库。
但是,这种方法有一个问题,如果用 SQL Server2000 生成了所有建表、视图、存储过程的一个脚本文件,用 ADO.NET 来执行这个脚本文件,就会因为脚本中有许多“ GO ”语句而出现错误。当然,我们可以把“ GO ”替换成换行符,利用 ADO.NET 一条条执行 SQL 语句。很显然,这样的效率比较低。
最好的办法是调用 osql 执行脚本。(或者创建一个数据库项目的 cmd 文件,而 cmd 文件建立数据库的时候也是调用的 osql )。
首先,我们新建一个 ASP.NET Web 应用程序, http://localhost/VbNetTest ,并打开 VbNetTest 项目
创建部署项目 ****
1. 在“文件”菜单上指向“添加项目”,然后选择“新建项目”。
2. 在“添加新项目”对话框中,选择“项目类型”窗格中的“安装和部署项目”,然后选择“模板”窗格中的“Web 安装项目”。在“名称”框中键入 Test Installer。
3. 单击“确定”关闭对话框。
4. 项目被添加到解决方案资源管理器中,并且文件系统编辑器打开。
5. 在“属性”窗口中,选择 ProductName 属性,并键入 GCRM。
将 VbNetTest 项目的输出添加到部署项目中 ****
1. 在“文件系统编辑器”中,选择“Web 应用程序”文件夹。在“操作”菜单上,指向“添加”,然后选择“项目输出”。
2. 在“添加项目输出组”对话框中,选择“项目”下拉列表中的“VbNetTest”。
3. 单击“确定”关闭对话框。
4. 从列表中选择“主输出”和“内容文件”组,然后单击“确定”。
创建安装程序类 ****
1. 在“文件”菜单上指向“新建”,然后选择“项目”。
2. 在“新建项目”对话框中,选择“项目类型”窗格中的“Visual Basic 项目”,然后选择“模板”窗格中的“类库”。在“名称”框中键入 DBCustomAction。
3. 单击“打开”关闭对话框。
4. 从“项目”菜单中选择“添加新项”。
5. 在“添加新项”对话框中选择“安装程序类”。在“名称”框中键入 DBCustomAction。
6. 单击“确定”关闭对话框。
创建自定义安装对话框 ****
1. 在解决方案资源管理器中选择“Test Installer”项目。在“视图”菜单上指向“编辑器”,然后选择“用户界面”。
2. 在用户界面编辑器中,选择“安装”下的“启动”节点。在“操作”菜单上,选择“添加对话框”。
3. 在“添加对话框”对话框中,选择“许可协议”对话框,然后单击“确定”关闭对话框。
4. 在“添加对话框”对话框中,选择“文本框 (A)”对话框,然后单击“确定”关闭对话框。
5. 在“操作”菜单上,选择“上移”。重复此步骤,直到“文本框 (A)”对话框位于“安装文件夹”节点之上。
6. 在“属性”窗口中,选择 BannerText 属性并键入:安装数据库.。
7. 选择 BodyText 属性并键入:安装程序将在目标机器上安装数据库。
8. 选择 Edit1Label 属性并键入:数据库名称:。
9. 选择 Edit1Property 属性并键入 CUSTOMTEXTA1。
10. 选择 Edit1Value 属性并键入:GsCrm。
11. 选择 Edit2Label 属性并键入:服务器名:。
12. 选择 Edit2Property 属性并键入 CUSTOMTEXTA2。
13. 选择 Edit2Value 属性并键入:(local)。
14. 选择 Edit3Label 属性并键入:用户名:。
15. 选择 Edit3Value 属性并键入:sa。
16. 选择 Edit3Property 属性并键入 CUSTOMTEXTA3。
17. 选择 Edit4Label 属性并键入:密码:。
18. 选择 Edit4Property 属性并键入 CUSTOMTEXTA4。
19. 选择 Edit2Visible、Edit3Visible 和 Edit4Visible 属性,并将它们设置为 False。
创建自定义操作 ****
1. 在解决方案资源管理器中选择“Test Installer”项目。在“视图”菜单上指向“编辑器”,然后选择“自定义操作”。
2. 在自定义操作编辑器中选择“安装”节点。在“操作”菜单上,选择“添加自定义操作”。
3. 在“选择项目中的项”对话框中,双击“应用程序文件夹”。
4. 选择“主输出来自 DBCustomAction(活动)”项,然后单击“确定”关闭对话框。
5. 在“属性”窗口中,选择 CustomActionData 属性并键入 /dbname=[CUSTOMTEXTA1] /server=[CUSTOMTEXTA2] /user=[CUSTOMTEXTA3] /pwd=[CUSTOMTEXTA4] /targetdir="[TARGETDIR]"。
附/targetdir="[TARGETDIR]"是安装后的目标路径,为了在DBCustomAction类中获得安装后的路径,我们设置此参数。
另外,安装后的路径也可以通过Reflection得到:
Dim Asm As System.Reflection.Assembly = _
System.Reflection.Assembly.GetExecutingAssembly
MsgBox("Asm.Location")
添加文件 ****
1. 将SQL Server生成的脚本文件DB.sql添加到“Test Installer”项目
2. 将安装文件LisenceFile.rtf添加到“Test Installer”项目
3. 在用户界面编辑器中,选择许可协议,设置LisenceFile属性为LisenceFile.rtf文件
工程中的文件 :
将代码添加到安装程序类中,DBCustomAction.vb类
Imports System.ComponentModel
Imports System.Configuration.Install
Imports System.IO
Imports System.Reflection
1<runinstaller( )="" true=""> Public Class DBCustomAction
2
3Inherits System.Configuration.Install.Installer
4
5# Region " 组件设计器生成的代码 "
6
7Public Sub New ()
8
9MyBase .New()
10
11' 该调用是组件设计器所必需的
12
13InitializeComponent()
14
15' 在 InitializeComponent() 调用之后添加任何初始化
16
17End Sub
18
19' Installer 重写 dispose 以清理组件列表。
20
21Protected Overloads Overrides Sub Dispose( ByVal disposing As Boolean )
22
23If disposing Then
24
25If Not (components Is Nothing ) Then
26
27components.Dispose()
28
29End If
30
31End If
32
33MyBase .Dispose(disposing)
34
35End Sub
36
37Private components As System.ComponentModel.IContainer
38
39<system.diagnostics.debuggerstepthrough()> Private Sub InitializeComponent()
40
41End Sub
42
43# End Region
44
45' 执行 SQL 语句
46
47Private Sub ExecuteSql( ByVal conn As String , ByVal DatabaseName As String , ByVal Sql As String )
48
49Dim mySqlConnection As New SqlClient.SqlConnection(conn)
50
51Dim Command As New SqlClient.SqlCommand(Sql, mySqlConnection)
52
53Command.Connection.Open()
54
55Command.Connection.ChangeDatabase(DatabaseName)
56
57Try
58
59Command.ExecuteNonQuery()
60
61Finally
62
63'Close Connection
64
65Command.Connection.Close()
66
67End Try
68
69End Sub
70
71Public Overrides Sub Install( ByVal stateSaver As System.Collections.IDictionary)
72
73MyBase .Install(stateSaver)
74
75' ------------------------ 建立数据库 \-------------------------------------------------
76
77Try
78
79Dim connStr As String = String .Format( "data source={0};user id={1};password={2};persist security info=false;packet size=4096" , Me .Context.Parameters.Item( "server" ), Me .Context.Parameters.Item( "user" ), Me .Context.Parameters.Item( "pwd" ))
80
81' 根据输入的数据库名称建立数据库
82
83ExecuteSql(connStr, "master" , "CREATE DATABASE " \+ Me .Context.Parameters.Item( "dbname" ))
84
85' 调用 osql 执行脚本
86
87Dim sqlProcess As New System.Diagnostics.Process
88
89sqlProcess.StartInfo.FileName = "osql.exe "
90
91sqlProcess.StartInfo.Arguments = String .Format( " -U {0} -P {1} -d {2} -i {3}db.sql" , Me .Context.Parameters.Item( "user" ), Me .Context.Parameters.Item( "pwd" ), Me .Context.Parameters.Item( "dbname" ), Me .Context.Parameters.Item( "targetdir" ))
92
93sqlProcess.StartInfo.WindowStyle = ProcessWindowStyle.Hidden
94
95sqlProcess.Start()
96
97sqlProcess.WaitForExit() ' 等待执行
98
99sqlProcess.Close()
100
101' 删除脚本文件
102
103Dim sqlFileInfo As New System.IO.FileInfo( String .Format( "{0}db.sql" , Me .Context.Parameters.Item( "targetdir" )))
104
105If sqlFileInfo.Exists Then
106
107sqlFileInfo.Delete()
108
109End If
110
111Catch ex As Exception
112
113Throw ex
114
115End Try
116
117' --------------------- 将连接字符串写入 Web.config-----------------------------------
118
119Try
120
121Dim FileInfo As System.IO.FileInfo = New System.IO.FileInfo( Me .Context.Parameters.Item( "targetdir" ) & "\web.config" )
122
123If Not FileInfo.Exists Then
124
125Throw New InstallException( " 没有找到配置文件 " )
126
127End If
128
129' 实例化 XML 文档
130
131Dim XmlDocument As New System.Xml.XmlDocument
132
133XmlDocument.Load(FileInfo.FullName)
134
135' 查找到 appSettings 中的节点
136
137Dim Node As System.Xml.XmlNode
138
139Dim FoundIt As Boolean = False
140
141For Each Node In XmlDocument.Item( "configuration" ).Item( "appSettings" )
142
143If Node.Name = "add" Then
144
145If Node.Attributes.GetNamedItem( "key" ).Value = "connString" Then
146
147' 写入连接字符串
148
149Node.Attributes.GetNamedItem( "value" ).Value = String .Format( "Persist Security Info=False;Data Source={0};Initial Catalog={1};User ID={2};Password={3};Packet Size=4096;Pooling=true;Max Pool Size=100;Min Pool Size=1" , _
150
151Me .Context.Parameters.Item( "server" ), Me .Context.Parameters.Item( "dbname" ), Me .Context.Parameters.Item( "user" ), Me .Context.Parameters.Item( "pwd" ))
152
153FoundIt = True
154
155End If
156
157End If
158
159Next Node
160
161If Not FoundIt Then
162
163Throw New InstallException( "web.Config 文件没有包含 connString 连接字符串设置 " )
164
165End If
166
167XmlDocument.Save(FileInfo.FullName)
168
169Catch ex As Exception
170
171Throw ex
172
173End Try
174
175End Sub
176
177End Class
178
179最后编译生成!
180
181安装界面:
182
183
184
185
186
187
188
189
190
191
192
193声明:本文</system.diagnostics.debuggerstepthrough()></runinstaller(>