水利档案软件C/S版部署与配置全实操指南

环境准备与基础软件安装

开始部署前，请确保你拥有服务器的管理员权限。以下步骤假设你在一台全新的Windows Server 2019标准版上进行操作。

服务器环境配置

安装必要的系统组件。以管理员身份打开PowerShell，执行以下命令：

``` Enable-WindowsOptionalFeature -Online -FeatureName IIS-WebServerRole, IIS-WebServer, IIS-CommonHttpFeatures, IIS-ManagementConsole, NetFx4Extended-ASPNET45, IIS-NetFxExtensibility45 ```

命令执行完成后，重启服务器。

接下来，安装数据库。本指南以SQL Server 2019 Express为例。从微软官网下载安装程序，下载地址为：https://go.microsoft.com/fwlink/?linkid=866658。下载后，运行安装程序，在“安装类型”步骤选择“基本”，所有设置保持默认，直接点击“安装”。安装完成后，记录下自动生成的SQL Server实例名称，通常为“SQLEXPRESS”。

档案软件服务端安装

获取水利档案软件C/S版的服务端安装包，文件通常命名为“WaterArchive_Server_Setup_v3.2.exe”。双击运行安装程序。

在“选择安装位置”界面，将路径修改为D:\WaterArchiveServer，避免安装在系统盘。在“组件选择”界面，确保“数据库连接工具”和“主服务程序”两项都被勾选。连续点击“下一步”直至安装完成。

安装结束后，不要立即启动程序。首先需要配置数据库连接。

数据库初始化与连接配置

此步骤将创建软件所需的数据库，并建立服务端与数据库的连接。

创建数据库与导入结构

打开安装时一同安装的“数据库管理工具”。在登录界面，服务器名称输入.\SQLEXPRESS，身份验证选择“Windows身份验证”，点击连接。

连接成功后，在左侧对象资源管理器中右键点击“数据库”，选择“新建数据库”。数据库名称填写WaterArchiveDB，其余选项保持默认，点击“确定”。

在软件安装目录D:\WaterArchiveServer\SQLScript下，找到名为Init_Database.sql的文件。在数据库管理工具中，点击“新建查询”，将上述SQL文件的内容全部复制到查询窗口中。在顶部工具栏的下拉菜单中，确保选中刚创建的“WaterArchiveDB”数据库，然后点击“执行”。等待所有命令执行完毕，状态栏显示“命令已成功完成”。

配置服务端连接文件

使用记事本或任何代码编辑器打开路径D:\WaterArchiveServer\Config\appsettings.json。找到“ConnectionStrings”部分，将其修改为如下内容：

``` { "ConnectionStrings": { "DefaultConnection": "Server=.\\SQLEXPRESS;Database=WaterArchiveDB;Trusted_Connection=True;MultipleActiveResultSets=true" }, "Logging": { "LogLevel": { "Default": "Information" } } } ```

修改完成后务必保存文件。

服务端启动与基础设置

完成数据库连接配置后，即可启动服务并进行基础设置。

启动主服务并验证

从开始菜单找到“水利档案服务管理器”，右键选择“以管理员身份运行”。在服务管理器中，点击“启动服务”按钮。观察下方日志窗口，当出现“服务已成功启动，正在监听端口 8080”的提示时，表示服务启动成功。

打开浏览器，在地址栏输入http://localhost:8080/api/health。如果页面返回{"status":"healthy"}的JSON字符串，则证明Web API服务运行正常。

初始化系统管理员

服务端首次运行，需要创建系统管理员账户。在浏览器中访问http://localhost:8080/admin/init。你会看到一个初始化页面。

在页面中填写以下信息：

• 管理员账号：sysadmin（建议使用此默认账号）
• 初始密码：设置一个不少于8位，包含大小写字母和数字的强密码
• 单位名称：填写你所属水利单位的全称

填写完毕后，点击“提交”按钮。页面提示“初始化成功”后，系统管理员账号即创建完成。请务必妥善保管此账号密码。

客户端安装与连接配置

服务端配置妥当后，需要在用户电脑上安装客户端软件。

客户端软件安装

获取客户端安装包“WaterArchive_Client_Setup_v3.2.exe”。在需要使用的办公电脑上运行该程序。安装路径可以保持默认（如C:\Program Files\WaterArchive），也可以根据单位规定修改。安装过程只需连续点击“下一步”即可。

配置服务器连接地址

安装完成后，首次启动客户端软件。会弹出一个“服务器连接配置”窗口。

在“服务器地址”栏中，输入档案服务器的IP地址或主机名。例如，如果服务器IP是192.168.1.100，则输入http://192.168.1.100:8080。端口号8080必须与服务器监听的端口一致。

点击“测试连接”按钮。如果弹出“连接成功”的提示，说明配置正确。点击“保存并登录”。

在登录界面，使用之前创建的sysadmin账号和密码登录系统。

核心功能配置与数据录入

登录系统后，需要进行基础数据配置，然后即可开始档案录入工作。

配置档案分类与元数据

以管理员身份登录客户端后，点击顶部菜单栏的“系统管理”。

选择“档案分类管理”。点击“新增”按钮，根据你单位的水利档案管理规定，逐级创建分类。例如：一级分类可为“工程建设类”，其下可创建二级分类“项目审批文件”、“设计图纸”等。请严格按照《水利档案分类大纲》进行操作。

接着，选择“元数据字段管理”。系统已预置了部分通用字段，如“题名”、“文号”、“责任者”、“形成日期”。你需要根据实际档案类型添加自定义字段。点击“新增字段”，填写字段名称（如“流域名称”、“工程等别”）、字段类型（文本、数字、日期等）以及是否必填。完成后点击保存。

将创建好的元数据字段与对应的档案分类进行关联。在“分类管理”中，选中一个分类，点击“绑定元数据”，勾选该分类下档案需要具备的字段。

录入第一份档案

点击主界面左侧的“档案录入”功能。

1. 首先选择这份档案所属的分类。
2. 系统会显示出你为该分类绑定的所有元数据字段表单。请逐项填写。
3. 在“电子文件”区域，点击“添加文件”按钮，选择要归档的电子文档（支持PDF, Word, Excel, 图片，DWG等格式）。
4. 填写和上传完成后，点击“提交归档”按钮。这份档案的条目信息和电子文件便保存至服务器数据库中。

你可以在“档案查询”功能中，通过题名、文号、日期等条件检索到刚刚录入的档案，并在线查看或下载电子文件。

日常维护与备份

为确保系统稳定和数据安全，需定期执行以下操作。

数据库自动备份设置

在档案服务器上，打开SQL Server Management Studio，连接到本地实例。

在左侧对象资源管理器中，找到“WaterArchiveDB”数据库，右键选择“任务” -> “维护计划” -> “维护计划向导”。

按照向导提示，创建一个新的维护计划，命名为“Daily_Backup_WaterArchiveDB”。在“选择维护任务”步骤，勾选“备份数据库（完整）”。在后续的“定义数据库备份任务”中，选择特定的数据库“WaterArchiveDB”，设置备份文件存放路径为D:\DB_Backup（请确保该目录已存在），并选择“备份文件扩展名”为bak。在“计划”设置中，配置为每天凌晨2:00执行。完成向导后，数据库便会在指定时间自动备份。

服务端日志清理

服务端日志默认存放在D:\WaterArchiveServer\Logs目录下。建议每月清理一次。你可以编写一个简单的批处理脚本cleanlog.bat，内容如下：

``` @echo off forfiles /p "D:\WaterArchiveServer\Logs" /s /m .log /d -30 /c "cmd /c del @path" echo Log files older than 30 days have been cleaned. ```

将此脚本加入Windows任务计划程序，每月1号执行一次即可自动清理30天前的日志文件。