楼宇自控工程配置指南：SMC建库、项目模板与备份恢复演练

简介《Desigo CC手册-04-Project Configuration-BA-CN工程配置》面向楼宇自动化系统集成、调试与运维人员聚焦Desigo CC项目落地时的配置流程与数据库管理问题适合作为工程实施阶段的查阅型操作参考。压缩包内仅含1个PDF文件大小约2.23MB内容围绕系统管理控制台SMC展开涵盖创建历史数据库HDB、通过模板/备份/新建三种方式实例化项目、配置事件处理与项目文件夹共享权限、备份项目及历史数据库等关键任务。手册还说明了恢复项目模板相比新建项目在减少工程投入和出错风险方面的优势并给出SMC工作流程、HDB参数设置及项目启动状态检查等线索便于读者按章节定位配置要点、核对实施步骤并形成排错思路。目前已有559人学习适合需要系统掌握Desigo CC工程配置的初中级技术人员查阅。1. 一份工程配置手册决定了上线那天你要不要熬夜接手一套楼宇自控集成系统的现场最难受的不是点位对不上而是服务器装好了、软件也点开了项目却建不起来——历史库连不上、端口被占、客户端打不开项目文件夹。这类问题的根因几乎都不在调试阶段而在工程配置那一步没按顺序走。这份《项目配置》分册讲的正好是这一段用系统管理控制台建历史数据库、用模板实例化项目、配置事件与文件夹共享权限、最后做备份。它面向的是做系统交付和运维的一线工程师不是给最终用户看的操作说明。新手可以照着逐步走熟手更该盯住里面的参数边界和顺序依赖因为这本册子里的每一步几乎都有前置条件。2. 系统管理控制台与历史数据库先把“记账本”建对系统管理控制台下称 SMC是这套平台所有工程动作的入口。它不负责画面组态也不负责点表编辑它只管“项目这个壳子怎么落地”系统和服务管理员账户、新建/恢复/升级项目、给项目挂扩展模块、创建或恢复该项目专属的 SQL 历史数据库HDB。顺序搞反了后面全是返工。2.1 SMC 在交付流程里的位置手册给出的工作流是一条带分支的单向链我按现场顺序复述一遍你会发现它其实是“先定项目类型再定存储最后才启动”启动 SMC开始菜单下的工具组或桌面快捷方式判断手里的东西属于哪一类项目备份、项目模板还是全新项目输入或编辑项目名称定义项目路径把项目链接到 HDB这一步可以放到保存前也可以延后但启动前必须有保存项目检查项目状态若显示“已过期”则先升级激活并启动项目可选添加扩展模块、配置系统与默认用户账户。这条链里有两个容易被跳过的点。第一个是第 4 步很多人先把项目恢复出来、急着启动看效果结果一启动就报数据库连接失败回头再补 HDB项目还得重新链接一次。第二个是第 6 步状态栏那一小块红色文字在投影仪上看不清现场经常被忽略直到启动报版本不兼容才发现。提示把这八步打印出来贴在机柜门上比事后翻手册快得多。工程配置阶段的返工成本基本等于重做一遍。2.2 扫描并链接 SQL 实例本地和网络两种走法HDB 不是平台自己造的文件它就是一个 SQL Server 数据库。所以 SMC 的第一步是“找到能托管它的 SQL 实例”。手册里的动作是扫描——扫描本地只搜本机扫描网络会去搜网段里广播出来的实例。扫到之后在列表里选中点“链接”把它挂到 SMC 下再点“添加”在该实例上创建 HDB。扫描失败是最高频的现场问题所以在打开 SMC 之前我一般先用几条命令把底摸清# 先看本机到底装了哪些 SQL 实例默认实例是 MSSQLSERVER命名实例是 MSSQL$实例名 Get-Service -Name MSSQL* | Select-Object Name, Status, DisplayName | Format-Table -AutoSize # 命名实例的自动发现依赖 SQL BrowserUDP 1434这个服务停了扫描网络就是空的 Get-Service -Name SQLBrowser | Select-Object Name, Status, StartType参数含义很直接MSSQL*通配能同时匹配默认实例和命名实例Status为 Stopped 说明实例没起来SMC 扫描时同样看不到SQLBrowser是命名实例的“广播员”它被停掉或者被安全策略禁用时只能靠手工填主机名\实例名来链接扫描这条路走不通。这两条查完再决定是修服务还是改用手工链接比在 SMC 里反复点“扫描”有效。确认实例存在之后还要确认“这个账号能不能建库”。SMC 链接用的是 Windows 凭据或 SQL 凭据权限不够时表现是链接成功、添加失败# 直连目标实例确认版本、确认当前登录名是否具备 sysadmin 角色 sqlcmd -S 10.10.20.31\INST_BA -U sa -P YourStrongPwd -Q SELECT VERSION; SELECT IS_SRVROLEMEMBER(sysadmin);-S后面是“主机\实例名”跨网段时建议直接用 IP避免名称解析拖时间-Q是一次性执行并退出适合做连通性探测IS_SRVROLEMEMBER(sysadmin)返回 1 才代表有建库和改恢复模式的权限返回 0 就别在 SMC 里折腾了先找数据库管理员开权限。2.3 建 HDB 的六个参数哪一个最容易埋雷扫描、链接、点“添加”之后SMC 会弹出一个配置界面手册把它归纳为六项功能性信息。这六项里有两项是“当场看不出问题、三个月后爆发”的我列成表对着看参数手册中的表述常见取值思路设错的后果数据库大小数据库和日志大小按趋势点数 × 采样周期 × 保留天数估先给 2 倍余量偏小会中途停止写入趋势曲线出现断档日志大小数据库和日志大小与数据库文件同量级别设成固定小值日志写满后整个库只读报警不再入库恢复方法恢复方法有定期完整备份就选简单恢复要按时间点恢复才用完整恢复选完整恢复却不做日志备份日志文件会一直涨文件位置文件位置独立数据盘不要和系统盘、项目文件夹同盘磁盘 IO 争抢历史查询变慢路径位置路径位置与文件位置一致路径不要带空格和中文个别组件解析路径失败所有人/用户HDB 所有人和用户平台服务运行账户 运维账号最小授权服务账户无权限时启动项目直接连不上库HDB 里到底记什么决定了你怎么估容量。手册写得很清楚它承载四类数据用户活动活动日志、警报及其处理事件日志、已发生的故障批处理消息、趋势数据值和上传数值日志。四类数据的写入特征完全不同——活动日志和事件日志是低频、小体积趋势数据是高频、随时间线性增长是容量的主要矛盾。所以容量估算的公式重心应该压在趋势点上而不是拍脑袋给个“20G 够了”。恢复方法这一项我踩过的坑最典型。选“完整”恢复模式理论上可以恢复到任意时间点听起来更安全但如果没人给这个库做日志备份日志文件会无限增长直到把数据盘吃满。反过来选“简单”恢复日志自动截断、空间可控代价是只能恢复到最近一次完整备份。工程配置阶段的默认建议是先把备份计划定下来再选恢复模式没有日志备份机制就不要选完整恢复。注意HDB 的所有人账户必须和平台服务的运行账户对得上。改过服务登录账户却忘了同步库权限表现是 SMC 里项目状态正常、一启动就报数据库登录失败排查时容易被误导到网络问题上。创建完成后 SMC 会给一个确认页别看到“成功”就关掉。回到 HDB 列表确认大小、路径、恢复模式和你填的一致——有些现场因为权限降级实际建出来的库用的是默认路径直到磁盘告警才发现数据全在 C 盘。3. 项目实例化三条路模板、备份、新建怎么选项目实例化是这套平台工程配置里最省时间也最容易省出问题的环节。手册明确给了三种方式恢复项目模板、恢复项目备份、创建新项目并且直接标注“恢复项目模板”是推荐方法。3.1 三条路的成本与风险对比先把三条路的账算清楚再决定点哪个按钮方式耗时量级适用场景主要风险恢复项目模板最快新项目、标准化交付模板版本落后于软件版本恢复后需升级恢复项目备份中等复用已调试好的同类工程备份里夹带旧账户、旧 IP、旧驱动配置创建新项目最慢极小规模试验、教学演示全部手工配置漏配概率高手册里那句“与创建新项目相比恢复项目模板花费的时间明显减少”其实还保守了。真正拉开差距的不是时间是漏配率。一个从零建的项目你要自己建图形文件夹、自己应用事件架构、自己建拓扑图、自己导报告、自己拉网络和驱动、自己配用户安全组和作用域——每一项都是独立的漏配点而漏配往往在联调阶段才暴露。模板之所以能压住这些是因为它是一份“预配置项目”手册列出了模板里已经做好的东西系统设置、应用程序设置已激活的扩展模块已创建的图形文件夹、已创建的拓扑图形已应用的事件架构已选择的客户端和用户配置文件已导入并按类别分类的报告已创建并已启动的驱动程序已创建的趋势定义已创建的网络和已分配的驱动程序已创建的逻辑视图、物理视图、用户视图已创建的用户和安全组并已分配作用域和应用程序权限。这份清单的价值在于它同时也是你的验收清单。恢复完模板逐条对着看一遍比凭空想“还差什么”靠谱得多。顺带说一句手册提到 HQ 交付的模板可用于 BA、消防和 TBS 三类项目选模板时别拿错专业方向的。3.2 恢复模板的完整步骤安装完平台后是没有默认项目的所以第一步是点“恢复项目模板”然后去模板目录里选。默认位置在安装目录下的GMSProjects\GMSMainProject\ProjTemplates进去先看一眼有什么# 进模板目录确认有哪些专业方向的模板、修改时间是否与当前软件版本匹配 cd D:\Program Files\BuildingPlatform\GMSProjects\GMSMainProject\ProjTemplates dir /O-D/O-D按时间倒序排一眼能看到最新交付的模板是哪一个。日期比软件安装日期还早很多的模板恢复后大概率要升级这一点在第 3.4 节展开。选好模板后进入配置环节手册列了四件事命名项目、提供项目路径或保持默认、把项目链接到 HDB、保存。四项里我只对两项有执念项目名称不要带空格、中文和特殊符号。它会被拼进文件夹名、服务名和部分日志路径带空格在脚本调用时经常要额外加引号忘了就报错项目路径放在数据盘别和 HDB 的数据文件放同一个物理盘。两者都是高 IO 的放一起在趋势查询密集时互相拖累。保存之后不要急着点启动。先切到“项目和系统信息”选项卡看状态这是手册里明确写的一步。3.3 端口号冲突多项目共存的硬约束单项目环境下端口号保持默认就行这一条没什么可说的。真正需要留意的是多项目场景手册写得很死——SMC 里存在多个项目时两个已启动的项目不能有相同端口号如果某项目的端口号和当前活动项目的端口号相同这个项目就无法启动。这个报错在现场很迷惑因为它不告诉你“端口被谁占了”。所以动手前先查# 查某个端口当前被哪个进程占用PID 拿到后可以反查进程名 Get-NetTCPConnection -LocalPort 8080 -State Listen | Select-Object LocalAddress, LocalPort, OwningProcess-State Listen只列监听态避免被大量 TIME_WAIT 记录淹没OwningProcess是 PID配合Get-Process -Id PID就能确认是不是另一个平台实例。如果没有 PowerShell 环境等价写法是netstat -ano | findstr :8080最后一列同样是 PID。我一般的做法是给每个项目建一张端口分配表写清楚项目名、端口号、服务器、负责人。项目超过三个还不做这张表早晚要在一个加班的晚上重新分配一遍端口。3.4 项目“已过期”状态与升级恢复模板或恢复备份之后状态栏可能显示“已过期”且是红色的。手册的处理很干脆必须升级项目然后才能正常启动。原因不难理解——模板或备份是在某个软件版本下生成的当前服务器上的组件版本更高项目结构需要一次迁移。这一步的坑在于“看起来能启动”。有些现场跳过升级直接激活界面确实起来了但个别扩展模块加载失败功能缺失要到联调才被发现。所以我的固定动作是状态不是“正常”就先点升级升级完再看一次状态确认没有残留告警然后才激活启动。最后一步是启动。SMC 里有多个项目时启动不等于激活需要手动把目标项目设为活动项目。判断依据看标题栏——标题栏显示的是活动项目名项目状态显示“已启动”两个条件都满足才算真正跑起来。4. 项目配置收尾事件处理、共享权限与客户端连接项目能启动只说明服务器端自洽了离“客户端能用”还有一段。手册在这部分讲了两件事配置项目以控制事件处理的行为以及设置项目文件夹的共享和安全访问权限让客户端能连上来。4.1 事件处理行为报警到底往哪走事件处理行为决定的是“报警产生之后发生什么”是否写入历史数据库的事件日志、是否弹窗提示、是否需要操作员确认、按什么优先级排队。这些不是画面上的东西而是项目级的配置改一次影响所有点位。工程配置阶段我通常按三条线过一遍入库线。哪些事件要进 HDB 的事件日志。全量入库最省心但事件风暴时会拖慢数据库只入关键事件省资源但事后追责没有依据。我一般按“报警 操作记录全入状态变化按需”来定。确认线。哪些等级需要人工确认。消防类专业对确认有硬要求BA 类可以宽松些但同一项目内要保持一致否则运维会混乱。通知线。是否联动弹窗、是否触发批处理消息。批处理消息本身也会写进 HDB等于放大了写入量容量估算时要算进去。这三条线定完再回头核对 2.3 节的容量估算——如果事件全量入库、趋势点又多前面给的库大小很可能不够。4.2 文件夹共享与 NTFS 权限两层都要过客户端连服务器本质是访问服务器上的项目文件夹。这里有两层权限必须同时满足SMB 共享权限和文件夹的 NTFS 安全权限。两层是“取交集”的关系任何一层拒绝都连不上而两层的配置界面完全不同这是最容易来回折腾的地方。我的习惯是先配 NTFS再配共享因为 NTFS 是更细的那一层# 给客户端运行账户授予项目文件夹的修改权限OI/CI 表示继承到文件和子文件夹 icacls D:\Projects\BA_Tower_A /grant DOMAIN\CC_Client:(OI)(CI)M /T # 查看共享层现有权限注意共享权限是另一套和 NTFS 取交集 net share BA_Tower_A参数说明(OI)是对象继承作用于文件(CI)是容器继承作用于子目录M是修改权限客户端要读写项目文件只给R读权限会在打开项目时失败/T递归应用到已有子目录新建的文件夹靠继承规则覆盖。net share不带参数列出全部共享带共享名时显示该共享的路径和权限。几个实操细节共享名建议和项目名一致但不要带空格共享权限给“更改”而不是“完全控制”完全控制里包含改权限的能力没必要给客户端账户不要用域管理员出一事就是一片。注意改完权限一定要用客户端账户实际登录一次验证。管理员账户测试永远成功因为它有“绕过权限检查”的特权这个假阳性坑过很多人。4.3 客户端连接的三项验证权限配完按顺序验三件事每件都过了再交付第一网络可达。客户端能 ping 通服务器且 SMB 端口通。Windows 防火墙默认可能只开了部分配置文件域网络和专用网络的规则是分开的。第二共享可访问。在客户端上用运行框输入\\服务器名\共享名能列出目录内容。能列出但打不开子目录说明 NTFS 层没过连列都列不出说明共享层或网络层没过。第三项目可加载。客户端连上之后在项目列表里能看到目标项目且能打开。到这一步才算真正打通。如果前两步都过、第三步卡住问题往往回到 3.3 节的端口或者项目还没被激活。5. 避坑与排查工程配置阶段最容易翻车的五个现场这一节全部来自现场。每条按“现象、原因、解决”写能对号入座就别猜。5.1 扫描网络扫不到任何 SQL 实例现象SMC 里点“扫描网络”列表空白但用 SSMS 从同一台机器能连上数据库。原因命名实例的发现依赖 SQL Browser 服务在 UDP 1434 上的广播这个服务被停用、被防火墙拦、或者实例被配置为隐藏实例三种情况都会让扫描结果为空。扫描本地正常、扫描网络为空基本就是这个原因。解决先看 SQL Browser 服务状态和启动类型被禁用就改成自动并启动再确认防火墙放行了 UDP 1434 和实例自身的 TCP 端口如果是隐藏实例别折腾扫描了直接手工填主机名\实例名链接。5.2 HDB 建好了项目一启动还是连不上库现象SMC 里 HDB 状态正常项目配置里也链接了它启动时报数据库连接失败。原因绝大多数是账户问题。HDB 创建时用的是一个账户平台服务运行起来用的是另一个账户后者在库上没有登录名或者没有权限。改过服务登录账户、换过机器、克隆过虚拟机都会触发。解决确认平台服务的登录身份然后在目标实例上给这个身份建登录名并映射到 HDB 的相应用户授予读写权限。改完重启服务再启动项目。排查时先看数据库端的登录失败日志比在客户端侧猜快得多。5.3 第二个项目起不来日志里没有任何有用信息现象第一个项目跑得好好的恢复第二个项目后怎么都启动不了事件日志里只有一条泛泛的失败。原因端口冲突。手册写得很明确两个已启动项目不能有相同端口号与活动项目端口相同的项目无法启动。但报错本身不指向端口。解决给每个项目分配独立端口用 3.3 节的命令确认目标端口没被占用。多项目环境建议维护端口分配表别靠记忆。5.4 客户端能看到共享文件夹但打不开项目现象客户端在资源管理器里能进共享目录、能看到文件客户端软件里打开项目报错。原因NTFS 权限不足。共享权限给够了、NTFS 只给了读表现就是“能看不能改”。另一种可能是项目文件夹下有子目录没继承到权限手工建目录时容易发生。解决用icacls重新下发带继承的修改权限并递归到已有子目录然后用客户端账户实测一次。别用管理员账户验证。5.5 备份显示成功恢复时却失败现象按流程做了备份真需要恢复的时候报错或者恢复出来的项目缺东西。原因备份范围不完整。项目文件夹和历史数据库是两套东西只备了其中一个或者备份时项目还在运行、文件处于占用状态备出来的副本不完整。解决备份前先停止项目项目文件夹和 HDB 一起备备份完成后立刻做一次恢复演练——恢复到临时路径能启动、能查到历史趋势才算这份备份有效。这一条在第 6 章展开。6. 备份不是终点把恢复演练做成固定动作手册把备份放在工程配置的最后一节位置很对。项目配完、客户端连上、验收签完字这时候最该做的一件事不是庆祝是立刻做一次备份并且验证它能恢复。先说备份范围。这套系统里“项目”和“历史数据库”是两个独立实体必须一起备。项目文件夹里是组态、图形、驱动配置、用户安全组HDB 里是活动日志、事件日志、批处理消息和趋势数据。只备项目文件夹恢复出来是个没有历史的空壳只备数据库恢复出来一堆对不上的孤儿数据。顺序上我一般先停项目再备文件夹最后备数据库——运行时文件被占用备出来的副本可能是半截的。再说验证。这是最容易被跳过、也最不该跳过的一步。备份任务返回“成功”只能说明复制动作完成了不能说明这份副本可用。我的验证清单是四步步骤动作通过标准1把项目文件夹恢复到临时路径目录结构完整文件数量与源一致2在 SMC 里用恢复项目备份的方式实例化恢复过程无报错状态为正常或可升级3链接一个测试用 HDB 并启动项目能激活标题栏显示正确的活动项目4抽查三条历史趋势和一个事件日志数据能查到时间戳连续无断档第三步的测试 HDB 很关键——不要拿生产 HDB 做恢复演练恢复动作有可能覆盖现有数据。单独建一个同实例下的小库专门用于演练成本很低。恢复方法的选择在这里会显出后果。如果 HDB 用的是完整恢复模式那么“完整备份 日志备份”才算一套完整方案只做完整备份的话两次备份之间的数据丢了就是丢了。如果图省事选了简单恢复模式就要接受“恢复到最近一次完整备份点”这个边界相应地完整备份的频率要提高。这个取舍在 2.3 节定参数的时候就要想清楚而不是等出事那天才翻手册。还有一个常被忽略的点升级之前先备份。项目状态显示“已过期”需要升级时升级动作会改动项目结构一旦升级中途失败没有备份就只能从头再来。升级前备一份、升级后验一次两步都做完再继续。我早年在一个改造项目上栽过跟头项目恢复模板、配好事件、客户端也连上了验收当天一切正常备份任务设了每天凌晨跑日志里全是成功。三个月后业主要求回溯一段报警记录才发现那个备份从来只备了项目文件夹HDB 根本没进备份范围事件日志最多只能查到数据库自身保留期内的数据。从那以后我每次交付前都强制走一遍“停项目、备文件夹、备 HDB、恢复到临时路径、抽查三条趋势”这套动作不走完不签字。这件事没有技术难度只有纪律问题而纪律恰恰是最容易松的那一环。希望帮到你。本文还有配套的精品资源点击获取