简介这是一份面向Teamcenter实施与运维人员的AWC2406安装图文指南聚焦使用Siemens Deployment Center完成从环境准备到部署脚本生成的全过程。内容涵盖了主机名修改、关闭防火墙与禁用IPv6、安装JDK17.0.3、Siemens License Server及SQL Server 2019等前置准备并详细讲解了将安装介质加入存储库、创建与配置环境、按序设置Active Workspace Client、Gateway、Corporate Server、Database Server等组件的操作要点同时特别说明了Database Server和TC密码不可包含特殊符号的限制与日志排查位置。资源以单个docx文档形式打包共1个文件约4.67MB图文步骤清晰适合作为安装过程中的对照手册。已有312人学习下载可帮助新手规避常见配置陷阱、提升AWC2406部署效率。1. 用 Deployment Center 装 AWC2406 是什么体验一次部署就是一次可回放的过程把 AWC2406 装进生产环境最忌讳的是把它当成一个普通安装包来“双击下一步”。AWC2406 是工作中心组件的 2024 年 6 月版本在基于 Deployment Center 的平台上安装的本质是“组件包 环境定义 配置下发”三件事的编排组件包先进入仓库环境绑定了目标机和执行 Agent配置在部署计划里统一下发。用 Deployment Center 安装不是为了省一次远程桌面的时间而是要让每台服务器的安装过程可回放、可回滚、可留档装完还能说清楚“这台机器上到底装了哪些东西、用的什么参数”。这篇文章写给三类人要交付产线环境的实施工程师、需要给现有平台加工作中心组件的运维以及被部署问题折腾过的二次开发。下面从装前检查一路讲到参数设置和 5 个高频坑点。2. 安装 AWC2406 的前置准备版本兼容、环境检查与参数规划安装操作在 Deployment Center 里只是最后一步前面 80% 的工作是确认环境。AWC2406 自带依赖关系目标机缺了运行时、数据库不匹配、目录空间不够安装过程都会在中途停下来而停下来的位置往往不是真正的原因所在。所以前置准备不是走流程是给后面省时间。2.1 版本依赖表2406 组件包对运行时的要求AWC2406 组件包是一个带清单文件的压缩包Deployment Center 在导入时会解析包内的 manifest.json把依赖项逐个列出来。依赖不满足时平台会给出两类提示error 表示直接不能装warning 表示“能装但不保证正确运行”。很多翻车现场就是忽略了 warning。下表是我在交付环境时固定使用的检查基线具体数值以你拿到的组件包内 manifest 为准检查项推荐要求说明操作系统64 位 Linuxsystemd 发行版或 Windows Server 2019/2022AWC 安装后会注册成系统服务systemd 或 Windows 服务管理运行时JDK 17 及以上 LTS64 位AWC2406 的 Java 进程直接基于 JDK 启动版本低了起不来数据库PostgreSQL 14 或 MySQL 8建议独立实例不要和平台自身的管理库混用基础平台版本不低于 24.02 示例区间以 manifest 为准2406 依赖基础平台的 API跨版本装会闪退目标机资源内存 16G 起步安装目录所在分区可用空间 20G 以上数据库初始化和日志膨胀比想象中占空间管理端浏览器Chrome / Edge 近两个大版本老浏览器打不开部署计划详情页排查问题寸步难行这里最容易忽略的是基础平台版本区间。AWC2406 调用的是基础平台的若干接口平台版本太旧时这些接口不存在安装能完成但启动必失败。Deployment Center 在导入组件包时就会读取 manifest 里的依赖声明并立即校验所以我一般建议把校验结果截图留档后面启动出问题可以回来对照。2.2 用命令完成环境检查Linux 与 Windows 两条路环境检查不要东点一下西看一下用命令一次扫完产出清晰。以下是我在 Linux 目标机上惯用的检查序列# Linux 目标机systemd 发行版 uname -a # 内核版本与架构x86_64 是底线 cat /etc/os-release # 确认发行版与版本 java -version # 确认 JDK 是否为 17 及以上 LTS free -g # 看总内存和可用内存低于 16G 直接预警 df -h /opt # 安装目录所在分区确认 ≥20G ss -lntp | grep :8080 # 确认目标端口未被占用 systemctl status deploy-agent # 看执行 Agent 是否在运行这几条命令按“系统 - 运行时 - 资源 - 端口 - Agent”的顺序写任何一条不满足都不用往下面走。ss -lntp里面的 8080 要替换成实际规划端口如果输出为空说明端口空闲如果有一条 LISTEN 记录说明已经有一个服务占着安装前必须先处理。Windows 目标机用 PowerShell 对应的检查逻辑一样# Windows PowerShell [System.Environment]::OSVersion.VersionString # 系统版本 Get-PSDrive -PSProvider FileSystem | Select-Object Name, { nFreeGB; e{[math]::Round($_.Free/1GB,1)} } # 检查各盘剩余空间 netstat -ano | findstr :8080 # 查看端口占用 Get-Service DeployAgent | Select-Object Status,Name # 确认 Agent 服务注意Deployment Center 只管应用层的安装与配置不负责装操作系统和 JDK。如果是离线环境JDK 必须在安装 AWC2406 之前手工装好并配好JAVA_HOME否则 Agent 执行安装脚本时会直接失败而且日志里只报“找不到 java”很容易让人误判成组件包问题。2.3 安装前要确认的 4 个关键参数环境检查通过后安装就变成参数问题。AWC2406 安装需要确认的核心参数就四类我一般会在部署前把它们写进一张小表里避免装到一半返回去问参数建议取值影响与注意点部署目录/opt/awc 或 D:\AWC安装后不可改改等于重装数据库连接串jdbc:postgresql://db-host:5432/awc2406库要提前建好应用账号要有建表权限服务账号svc_awcLinux 系统用户或 Windows 域账号必须对部署目录有写权限端口绑定权限要够License 文件安装时直接导入授权类型与节点数必须提前核对错了授权无效这里有个容易踩的细节部署目录必须一次定死。虽然 Deployment Center 支持后续改配置但目录是写进服务定义和脚本路径里的后期在界面上改往往会出现服务启动脚本找不到旧路径文件的情况。数据库密码、服务端口、JVM 堆大小这些可以在安装后通过配置覆盖更新目录和账号不行。所以装 AWC2406 之前先把表格填完、由第二个人复核一遍比装完出问题再补救便宜得多。3. 在 Deployment Center 中导入 AWC2406 组件包并创建部署环境前置检查做完剩下的工作全部在 Deployment Center 里完成。它的工作方式像“仓库 环境”两层结构组件包先入仓库再被绑定到具体环境。环境定义了一台目标机和一组部署参数一个环境对应一个执行 Agent。理解了这个模型界面上那些按钮就不会让人觉得杂乱。3.1 登录管理端导入组件包把 AWC2406 放进组件仓库Deployment Center 通常独立部署在一台管理服务器上浏览器登录后第一个要操作的是“组件仓库”页面。AWC2406 组件包是一个 tar.gz 压缩包包内有 bin、conf、webapps 目录和 manifest.json。上传动作就是把包推进仓库平台会自动解包、校验文件完整性、解析依赖并登记版本。我习惯直接用 API 上传比在界面上拖拽更可控。以下是等价的命令行方式# 上传 AWC2406 组件包到 Deployment Center 的组件仓库 curl -u admin:${ADMIN_PASSWORD} \ -F fileAWC2406.tar.gz \ https://dc-server:8443/api/v1/component-repository/upload?version24.06上传成功后接口会返回一个 JSON里面的componentId和version字段是后面绑定环境时要用的标识。-F表示以表单方式提交文件version24.06是给组件包显式标版本防止和仓库里同名旧包混淆。${ADMIN_PASSWORD} 这种写法是让密码不要在命令行明文出现可以用环境变量注入。这里有个离线环境专门要注意的点组件仓库如果配置的是共享存储上传前先确认磁盘剩余空间。AWC2406 解包后一般会比原始包大不少仓库空间不足时上传动作会“看起来成功、实际失败”只在服务端日志里留一条磁盘写入错误界面上很难发现。3.2 创建部署环境并绑定目标服务器组件包入仓库后接着创建一个部署环境。环境就是一套完整的部署单元定义装在哪台机器、安装目录在哪、用什么服务账号、目标端口是多少。一个环境只能绑定一个 Agent如果有多台目标机就创建多个环境这样每一台的参数都是独立的。界面上通常分五步填环境名称、选择目标主机、配置 Agent 连接、指定部署目录、设置服务账号。我一般也会用接口来建便于沉淀成自动化脚本# 创建名为 prod-line1 的部署环境并绑定目标机 host-01 curl -s -X POST https://dc-server:8443/api/v1/environments \ -H Content-Type: application/json \ -d { name: prod-line1, agent: host-01, baseDir: /opt/awc, accounts: [{user: svc_awc, group: app-admin}] }baseDir就是上一章说的部署目录这里定了后面就不改。accounts指定安装完成后服务以哪个账号运行这个账号需要有 baseDir 的读写权限。agent字段用的是目标机注册到 Deployment Center 时的主机名不是随意填的 IP填错了环境会创建成功但部署时连不上 Agent。创建环境后第一件事是测试连通性。Deployment Center 一般会提供一个“连接测试”按钮实际就是让管理端向 Agent 发一个心跳包。这个步骤别跳过很多部署卡死问题在环境阶段就能暴露出来比如 Agent 端口被防火墙挡了、Agent 证书过期了这些在测试连通性时都会直接报错。3.3 依赖组件的自动解析与人工干预把 AWC2406 添加到环境后Deployment Center 会重新计算依赖清单。依赖项在界面上有三种状态灰色表示已满足黄色表示待安装红色表示冲突。常见依赖是基础平台运行时和公共组件库AWC2406 会在 manifest 里声明它需要的版本区间。依赖项状态含义处理方式灰色已满足环境里已有兼容版本直接进入部署计划黄色待安装缺少但可以自动补齐勾选让平台一并安装红色冲突版本区间不满足先升级基础平台再回来装人工干预的重点是黄色项。平台会默认勾选“自动安装缺失依赖”这通常没问题但要注意依赖的安装顺序——必须先装基础平台运行时再装 AWC2406顺序反了会导致 2406 在启动时找不到类。Deployment Center 生成的部署计划会显示执行顺序我习惯在点部署前打开“部署计划”页检查一遍组件顺序而不是直接信任默认排序。如果界面上出现红色状态却允许“强制安装”我的建议是直接停手。强制安装意味着把不兼容的包放到环境里后面启动失败的排查成本远高于先升级基础平台。这一步省掉的时间后面都会加倍还回来。4. 执行 AWC2406 安装配置项说明与日志追踪环境创建完毕、依赖解析全绿就可以发起安装了。这个阶段的核心不是“点按钮”而是看懂部署计划里每一步的推进状态以及配置项填得对不对。AWC2406 的安装配置集中在这几个方面数据库连接、服务端口、JVM 内存、日志级别。4.1 发起部署六步编排与失败停靠点在 Deployment Center 界面上选择环境点“部署”平台会先生成一份部署计划将 AWC2406 的安装拆成六个步骤解压组件包到目标机的临时目录写入应用配置数据库、端口、账号等初始化数据库表结构注册系统服务systemd service 或 Windows Service启动服务进程执行健康检查回调每个步骤在执行过程中有独立状态等待、执行中、完成、失败。失败时会自动停在对应步骤不会继续往下跑这是 Deployment Center 一个很实用的设计——数据库初始化失败时服务注册和启动都不会发生恢复现场的成本就低很多。执行前平台会显示“配置差异预览”把当前环境已有配置和这次要下发的配置做对比。这一步我从来不看都不看就点确认而是逐行核对数据库连接串、端口、目录三项确认没有意外的变更。部署计划里的每一处改动都会写进执行记录这也是事后回溯问题的依据。4.2 数据库连接、端口与内存三个必调参数AWC2406 的配置在 Deployment Center 里以“配置覆盖”的方式管理平台会把这些参数写进目标机的应用配置文件。以 YAML 格式为例最需要关注的三块如下awc: server: port: 8080 # 对外服务端口需与网关约定一致 contextPath: /awc # 应用上下文路径外部访问路径 datasource: url: jdbc:postgresql://db-host:5432/awc2406 username: awc_app password: ${DB_PASSWORD} jvm: heapMaxMB: 4096 # 最大堆内存生产建议 4G 起步 heapMinMB: 1024 # 初始堆内存避免启动时反复扩容三个参数中最多坑的是数据库连接串。url里的库名、IP、端口任何一项不对安装日志都会报连接失败但报错位置在数据库初始化步骤很多人会误以为是数据库脚本问题。username建议使用最小权限的应用账号只需要对 awc2406 库有建表、增删改查权限不要用超级管理员。password不要明文写在配置里平台一般支持引用部署中心保存的保密配置项用 ${...} 占位执行时再注入。JVM 堆内存按 4G 起步。堆给太小AWC 启动时频繁 Full GC健康检查接口响应超时平台会判定启动失败并自动回滚服务状态日志里却看不到明显错误。启动前把变量的堆内存参数改到合理值可以少赔一晚上睡眠。4.3 安装日志怎么看从“黑匣子”里拿到有效信息安装出问题时第一动作不是重启而是看日志。AWC2406 安装相关的日志有两份一份在管理服务器的部署计划执行日志里记录每一步的状态流转一份在目标机的安装日志里记录实际脚本输出和进程启动信息。# 管理端跟踪部署计划执行进度 tail -f /opt/deployment-center/logs/deployplan_20280201_01.log # 目标机查看安装阶段的关键错误 grep -n -i error\|exception /opt/awc/logs/awc-install.log | tail -50 # 目标机查看安装步骤推进标志 grep -n step completed /opt/awc/logs/awc-install.log | tail -20看日志有一个基本方法先看部署计划日志里停在哪一步再去看目标机对应步骤的详细输出。step completed是步骤推进的标志如果最后一条记录停在“init database”之前问题就在配置写入或连接阶段如果已经进入了启动步骤但看不到 completed说明进程启动失败这时候才需要抓应用日志。ERROR 关键字要连着上下文看不要只抓一行就下结论很多 ERROR 后面跟的是 “retry” 或 “recover”并不代表真的失败。5. 安装 AWC2406 的 5 个常见坑现象、原因与排查Deployment Center 把安装过程编排得再顺也架不住环境差异。下面 5 个坑是从实施现场遇到的真实问题里剥出来的按“现象 → 原因 → 解决”三明治写照着排查能省大量时间。5.1 部署一直停在“等待执行”现象在部署计划页点完“部署”状态长时间停在“等待执行”目标机上没有任何动作Agent 侧日志也不更新。原因执行 Agent 与 Deployment Center 之间的心跳断了。常见于目标机重启后 Agent 服务没有自动拉起或管理端与目标机之间的 Agent 端口被防火墙规则拦截。Agent 静默挂掉时界面不会主动报错只显示“等待执行”。解决先确认 Agent 进程状态再测试端口连通性。systemctl status deploy-agent # 确认 Agent 服务是否 running ss -lntp | grep :4444 # 4444 为 Agent 监听端口按实际配置替换如果 Agent 是死的启动后再回部署界面点“重试”如果 Agent 活着但端口不通去防火墙放行对应端口。排查这类问题最怕在界面上反复点“重新部署”Agent 心跳不通时点多少次都没用。5.2 数据库连接串没问题却连不上现象安装到“初始化数据库”一步失败目标机安装日志报Connection refused或password authentication failed但在数据库客户端里用同一个账号密码能连上。原因三个常见坑点按频率排序一是数据库所在服务器防火墙没有放行目标机 IP应用服务器连不上二是密码里包含 $、、# 等字符在配置中被当成变量或注释截断了三是 JDBC 连接串里写的是localhost而数据库在另一台机器上。解决在目标机上直接用与 AWC 相同的连接串做连通性测试排除平台干扰# 在目标机上用同名参数验证返回 DB_OK 再回来重新部署 jdbc-ping --url jdbc:postgresql://db-host:5432/awc2406 \ --user awc_app --password如果jdbc-ping返回 DB_OK但安装依然失败问题基本在密码字符上。处理方式是用 Deployment Center 的保密配置项存储密码避免经过配置文件时发生转义。如果返回不了 DB_OK回到数据库侧加白名单、确认监听端口即可。5.3 服务显示已启动但端口不通现象部署计划的最后两步都显示完成Deployment Center 标记 AWC 服务为运行中但浏览器访问业务页面超时ss -lntp看不到端口在监听。原因最容易出现的是服务进程起来了、Web 容器却没成功绑定对外端口。背后的典型原因是服务账号没有绑定端口权限端口被系统策略挡住进程启动后监听失败但不退出。另一个常见原因是配置里绑定了127.0.0.1外部访问自然不通。解决先看端口监听状态和监听地址ss -lntp | grep :8080如果没有任何输出检查应用配置里的bindAddress改为0.0.0.0或明确的外网网卡地址如果看到监听在127.0.0.1改完配置后重启服务。Windows 环境下还有一步常见操作给服务账号赋予该 URL 的监听权限。netsh http add urlacl urlhttp://:8080/ usersvc_awc这一步做完再重置服务端口就能正常绑定了。5.4 装到一半失败想手动删目录重装现象数据库初始化失败后目标机上已经生成了解压目录和部分配置。实施人员为了重置现场直接手动删除安装目录然后回到 Deployment Center 重试安装结果反复失败。原因Deployment Center 在执行安装前会在目标机上记录部署状态手动删除目录后平台认为已经存在的版本与真实文件系统不一致后续解包、写配置都会因为路径状态异常而中断。这是典型的“手动动作破坏了平台状态”的场景。解决用平台自身的回滚功能回到上一个版本不要手动删除任何目录。# 查看当前环境可回滚的版本列表 dc-ctl rollback --list --env prod-line1 # 输出历史版本与回滚点选择上一个正常版本执行回滚 dc-ctl rollback --env prod-line1 --release previous-release-id回滚的原理是平台在每个 release 目录之间做整体切换旧的版本目录会完整保留回滚后文件状态与平台记录重新一致然后才能再次发起安装。记住一条纪律Deployment Center 管理的环境任何对安装目录的手工改动都是危险的想改文件先停服务想重置先用平台工具。5.5 组件包有警告还强制装启动即闪退现象导入 AWC2406 时提示“基础平台版本不满足存在兼容性风险”部署时点了强制安装安装过程全部完成但服务进程启动后自动退出应用日志里没有 ERROR只有一行 WARN 提示某个接口不存在。原因AWC2406 依赖基础平台提供的 API基础平台版本过低时接口缺失Service 启动到初始化阶段调不到接口直接退出。因为进程退出不涉及异常抛出应用日志里往往只有 WARN非常误导人。解决回头查看组件包导入时的依赖校验记录确认缺失的依赖项然后把基础平台升级到 manifest 要求的版本区间再重新部署 AWC2406。升级后重新执行部署计划即可不需要卸载重装。生产环境永远不要用“强制安装”按钮凡是出现红色依赖状态先升级基础组件再装工作中心组件顺序不能省略。6. 装完 AWC2406 后的验证与日常维护技巧服务能启动只算安装完成了一半验证通过才叫交付。我有一套半小时验证清单装完每台机器都按这个顺序走一遍不走完不交。验证项操作期望结果服务状态systemctl status awc或服务管理器状态为 active/running健康检查curl -s http://host:8080/awc/api/health返回 JSON 且 status 为 UP数据库表登录数据库查看 awc2406 库表清单核心业务表已创建授权在管理端查看 License 页面显示的节点数与采购一致日志grep -c ERROR /opt/awc/logs/awc-app.log数量为 0 或仅可接受的已知告警健康检查这条最值得盯紧/awc/api/health返回 UP 说明进程和依赖都活着这是自动化验证的基础。如果只是ss -lntp看到端口在听不能说明业务可用。数据库表的验证可以放到最后用一条命令确认表存在即可psql -U awc_app -d awc2406 -c \dt awc_* | head -20日常维护方面我给自己定了几条不成文的习惯。一是每次部署前在 Deployment Center 里导出配置快照这个 JSON 文件记录了环境全部参数回滚之后可以用它恢复配置。二是组件包进入仓库后不要覆盖同名版本新包新建版本号保持仓库里每个版本可追溯。三是升级前备份数据库和当前 release 目录哪怕只是小版本变更也备份备份成本远低于恢复成本。有一次我只是改了个内存参数就上线结果依赖版本没核对半夜被叫起来看日志从那以后任何一次部署我都先把部署计划的差异预览截图留档确认每一行改动都是预期的。这套流程跑顺之后装 AWC2406 就从一个“高危操作”变成了每天可以重复执行的标准化动作。希望帮到你。本文还有配套的精品资源点击获取