2026/10/31 11:15:11

AWC2406安装复盘:Deployment Center编排与部署脚本避坑

AWC2406安装复盘:Deployment Center编排与部署脚本避坑 简介面向Teamcenter实施与运维人员的AWC2406安装配置文档围绕使用Deployment Center完成部署这一典型场景展开适合需要搭建测试环境、复现安装流程或查漏补缺的初中级工程师参考。压缩包内仅含1个docx文档整体约4.67MB内容集中、便于随查随用。文档以要点式记录关键前置条件、界面入口与结果校验覆盖安装前的主机名与网络设置准备、JDK17.0.3及许可服务和SQL Server2019等基础依赖也涉及安装介质入库、日志排查、环境创建与软件选择、Active Workspace Client与Gateway、Corporate Server、Database Server等组件的配置顺序以及部署脚本生成等关键环节并特别提示数据库与TC密码的符号限制等易错点。已有312人学习下载。读者可借此快速建立AWC2406部署的整体脉络定位介质添加失败、组件状态未完成、部署包查找等常见问题作为官方文档之外的速查笔记和排错参考。1. 某台测试机上的AWC2406安装复盘Deployment Center把零散动作收成一条链某实验室的测试机在AWC2406安装时手工装完JDK、License Server 4和SQL Server 2019后最容易翻车的不是某个组件装不上而是Teamcenter Deployment Center这条编排链路没对齐介质有没有进存储库、环境Env_Tc的组件状态是不是100%、生成的deploy.bat参数有没有带对。它解决的是把零散安装动作收束成可复现脚本的问题适合要在一台或几台Windows主机上复现AWC2406部署的从业者。下面按我实际踩坑后重走的顺序拆先把基线打牢再进存储库、环境、组件和脚本。2. 装前基线主机名、hosts、防火墙与JDK17的落点2.1 主机名与hosts的对照表怎么落地安装笔记里黑色底纹覆盖的主机名是示例值落到自己环境要逐台替换不能直接照抄。主机名一旦进入Deployment Center生成的环境配置后面再改会牵动License、数据库连接和AWC网关地址返工成本很高。我一般先画一张角色对照表把应用机、数据库机、网关机分开再统一改主机名和hosts。示例可以按下面这种粒度写IP段用测试环境自己的规划不要照搬。角色示例主机名hosts行示例说明应用与部署中心tc-app0110.10.10.21 tc-app01装Deployment Center和TC组件数据库tc-db0110.10.10.22 tc-db01SQL Server 2019实例所在机AWC网关awc-gw0110.10.10.23 awc-gw01Active Workspace GatewayWeb层tc-web0110.10.10.24 tc-web01Teamcenter Web Tier改主机名用PowerShell最稳改完必须重启再继续装。下面这段只改名字不碰域和网络配置如果机器已经加域先确认改名不会影响域信任。# 以管理员身份运行把 tc-app01 换成规划表中的主机名 Rename-Computer -NewName tc-app01 -Restart逻辑说明Rename-Computer只改计算机名-Restart让改名立即生效避免后面装JDK和Deployment Center时还读到旧名称。参数说明-NewName取对照表里的短主机名建议不超过15个字符不要带下划线和中文-Restart会直接重启执行前保存好手头工作。hosts文件建议用追加方式写不要整段覆盖尤其是机器上已有其他解析记录时。下面这段会取当前机第一个非回环IPv4地址把“IP主机名”追加到hosts适合单机测试多机环境还是按对照表手工写更可控。# 以管理员身份运行先备份hosts Copy-Item C:\Windows\System32\drivers\etc\hosts C:\Windows\System32\drivers\etc\hosts.bak $hostName $env:COMPUTERNAME $ip (Get-NetIPAddress -AddressFamily IPv4 | Where-Object {$_.IPAddress -notlike 127.*} | Select-Object -First 1).IPAddress $ipt$hostName | Out-File -FilePath C:\Windows\System32\drivers\etc\hosts -Append -Encoding ascii逻辑说明先备份hosts再用当前计算机名和IPv4地址拼一行解析记录编码用ascii避免记事本写入BOM导致解析异常。参数说明$env:COMPUTERNAME是当前主机名-notlike 127.*排除回环地址-Append保证不覆盖已有内容。多机环境把$hostName和$ip换成对照表里的值逐条追加最后用ping tc-db01和ping awc-gw01各验一次。提示hosts改完先别急着装Deployment Center用ping -4 主机名确认解析到IPv4地址避免后面组件连到IPv6地址上。2.2 防火墙、IPv6与JDK17.0.3的检查顺序测试环境里我通常先关防火墙、禁用网卡IPv6再装JDK17.0.3顺序反了容易出现“JDK装完但Deployment Center服务起不来”的假故障。关防火墙只适合隔离的测试网生产环境要按端口放行不能照搬。禁用IPv6也要先确认远程桌面和监控没有走IPv6否则断连后只能去机房。# 以管理员身份运行网卡名先用 Get-NetAdapter 查 Set-NetFirewallProfile -Profile Domain,Public,Private -Enabled False Disable-NetAdapterBinding -Name 以太网 -ComponentID ms_tcpip6 Get-NetAdapterBinding -Name 以太网 | Where-Object {$_.ComponentID -eq ms_tcpip6}逻辑说明第一条关闭域、公用、专用三套防火墙配置第二条解绑指定网卡的IPv6协议第三条回读绑定状态确认Enabled为False。参数说明-Name 以太网要换成Get-NetAdapter里看到的实际网卡名-ComponentID ms_tcpip6是IPv6协议绑定标识不要改成其他组件。JDK装完后不要只看安装向导的完成页要在新开的CMD里验版本。Deployment Center和TC组件依赖JAVA_HOME路径里不要带中文和特殊符号版本按输入里的17.0.3对齐。# 新开管理员PowerShell设置机器级JAVA_HOME [Environment]::SetEnvironmentVariable(JAVA_HOME,C:\Program Files\Java\jdk-17.0.3,Machine) [Environment]::SetEnvironmentVariable(Path,$env:Path ;%JAVA_HOME%\bin,Machine) java -version逻辑说明SetEnvironmentVariable写机器级变量避免只对当前窗口生效第二行把%JAVA_HOME%\bin追加到Path最后用java -version验证输出为17.0.3。参数说明Machine表示系统级JDK路径按实际安装目录改但目录名尽量保持jdk-17.0.3这种短格式。设置完关掉所有CMD窗口重开否则旧窗口读不到新变量。2.3 License Server 4与SQL Server 2019的最小可用验证License Server 4和SQL Server 2019不要等Deployment Center报错才回头查装完就先做最小验证。License服务看服务状态和端口SQL看版本、认证模式和1433端口。下面先查许可相关服务服务名按实际安装结果过滤不要硬编码不存在的名字。# 查许可相关服务状态 Get-Service | Where-Object {$_.Name -match license|flex -or $_.DisplayName -match license} | Format-Table Name,DisplayName,Status,StartType逻辑说明用名称和显示名双条件过滤避免只匹配英文服务名漏掉显示名里的License。参数说明-match是正则匹配license|flex覆盖常见许可服务命名Format-Table只影响展示不影响结果。看到服务不是Running就先启动再看启动类型是不是自动。SQL Server 2019装完后用sqlcmd验版本和认证模式。Teamcenter常用做法是启用混合认证并固定1433端口实例名和排序规则按官方文档和现场规范来不要凭感觉选。-- 在SQL Server所在机用sqlcmd执行 SELECT SERVERPROPERTY(ProductVersion) AS ProductVersion, SERVERPROPERTY(Edition) AS Edition, SERVERPROPERTY(IsIntegratedSecurityOnly) AS WindowsOnly;逻辑说明第一条查产品版本第二条查版本类型第三条查是否只允许Windows认证WindowsOnly0表示混合认证已开。参数说明ProductVersion应能对上SQL Server 2019的版本线Edition按实际授权显示WindowsOnly为1时要在SQL配置里改混合认证并重启实例。端口验证用Test-NetConnection从应用机打到数据库机避免只在本机通、跨机不通。# 从tc-app01打tc-db01的1433 Test-NetConnection -ComputerName tc-db01 -Port 1433逻辑说明Test-NetConnection会同时做解析和TCP握手TcpTestSucceeded为True才算通。参数说明-ComputerName写hosts里的主机名顺便验证解析-Port 1433按SQL实例实际监听端口改。不通时先查SQL TCP/IP协议是否启用再查防火墙和端口占用。注意Deployment Center里配置Database Server和TC密码时不允许特殊符号后面第5章会单独拆这里装SQL时先把测试密码定成纯字母数字能省一轮返工。3. 把介质塞进Teamcenter Deployment Center存储库路径、日志与活动介质3.1 介质解压路径为什么要短AWC2406介质解压到D:\DeploymentCenter\repository\software下面路径尽量短不是洁癖是Windows路径长度和repotool扫描共同决定的。解压时多套一层同名目录、目录名带空格或中文后面存储库添加介质就容易出现“文件在但活动介质不出现”。我一般把目标目录控制在三层以内例如software\AWC2406不要写成software\AWC2406\AWC2406\disk1。# 以管理员身份运行源包按实际介质名改 $src D:\media\AWC2406.zip $dst D:\DeploymentCenter\repository\software\AWC2406 Expand-Archive -Path $src -DestinationPath $dst -Force逻辑说明Expand-Archive把介质解到短路径下-Force允许覆盖上次失败的残留文件。参数说明$src是介质压缩包位置不要放在网络盘$dst固定到存储库software下目录名用版本号-Force会覆盖同名文件执行前确认目标目录没有要保留的手工改动。解压完先看目录层级确认没有出现同名嵌套。下面这条只列两层够判断介质根目录是不是直接落在AWC2406下。# 检查解压后的目录层级 Get-ChildItem D:\DeploymentCenter\repository\software\AWC2406 -Depth 2 | Select-Object FullName,PSIsContainer逻辑说明-Depth 2限制递归深度避免刷屏PSIsContainer区分目录和文件。参数说明路径按实际解压目录改如果看到AWC2406\AWC2406这种嵌套把内层内容上移一层再继续。介质里常见的disk目录、setup文件以实际包为准不要自行改名。3.2 登录存储库添加介质与活动状态确认登录Deployment Center后进软件存储库添加介质再看活动介质列表。界面操作不复杂关键是添加后不要只看“上传完成”要回到存储库列表确认状态是活动。下面先确认本机Deployment Center相关服务在跑服务名按实际安装结果过滤不要硬编码。# 查Deployment Center相关服务 Get-Service | Where-Object {$_.DisplayName -match deployment|repotool|tc} | Format-Table Name,DisplayName,Status,StartType逻辑说明用显示名过滤部署中心和存储库工具服务确认不是停止状态。参数说明deployment|repotool|tc是宽匹配实际服务名可能不同Status为Running、StartType为Automatic才算就绪。服务没起时先启动再刷新浏览器。添加介质的操作顺序我习惯固定成下面几步避免漏掉“更新选定的软件”登录Deployment Center进入软件存储库。点击添加介质选择D:\DeploymentCenter\repository\software\AWC2406下的介质根目录。等待解析完成回到存储库列表刷新。确认介质状态为活动版本显示与AWC2406一致。如果列表里出现重复条目先删掉失败条目再重加不要两个版本同时挂着。提示添加介质时不要同时挂AWC2406和其他版本环境里选软件时容易选错测试机上只保留当前要装的活动介质最省心。3.3 添加失败看repotool日志的排查路径添加介质失败时界面提示通常很笼统真正的黑匣子在D:\DeploymentCenter\webserver\repotool\logs。我一般先按时间倒序找最新日志再看末尾100行重点搜ERROR、Failed、extract、repository这些词。下面这段先列最新三个日志文件不直接打开一大堆。# 找最新repotool日志 Get-ChildItem D:\DeploymentCenter\webserver\repotool\logs -Filter *.log | Sort-Object LastWriteTime -Descending | Select-Object -First 3 FullName,LastWriteTime,Length逻辑说明按最后写入时间倒序取最近三个先看时间和大小判断是不是本次操作产生的日志。参数说明-Filter *.log只匹配日志-First 3避免一次列太多Length为0说明日志没写进去要查服务账户权限。找到文件后看尾部不要全文通读。下面这条把最后120行拉出来配合关键字过滤。# 把路径换成上一步查到的日志文件 $log D:\DeploymentCenter\webserver\repotool\logs\repotool.log Get-Content $log -Tail 120 | Select-String -Pattern ERROR|Failed|extract|repository|permission逻辑说明-Tail 120只看尾部Select-String过滤关键行减少噪音。参数说明$log换成实际文件名关键字按报错调整压缩包损坏可以加checksum权限问题可以加denied。看到路径过长就回3.1缩路径看到权限拒绝就给repotool服务账户加software目录读权限。常见失败原因我归成四类解压路径太长或嵌套、压缩包传输损坏、服务账户对repository\software没有读权限、同一介质重复添加。处理顺序是先缩路径重解压再校验包大小再查权限最后清重复条目。不要一上来重装Deployment Center多数时候日志已经指出问题在介质侧。4. 创建Env_Tc环境软件、选项、应用程序与组件的顺序4.1 创建环境与概述改名介质变成活动介质后下一步是创建环境。环境名我习惯用Env_Tc短、能一眼看出是TC测试环境后面部署脚本目录也会带这个名字。创建后进入环境点添加再在概述里改名称。改名要趁组件还没配完配到一半再改容易让已生成的配置对不上。# 确认部署脚本目录下出现Env_Tc Get-ChildItem D:\DeploymentCenter\repository\deploy_scripts -Directory | Select-Object Name,LastWriteTime逻辑说明环境创建后会在deploy_scripts下生成对应目录用目录名反查环境是否落盘。参数说明路径按实际Deployment Center安装位置改-Directory只列目录看到Env_Tc且时间戳是本次操作说明环境已建立。没有出现时先回界面确认环境是否保存成功。概述里除了名称还要核对主机名、域、时区这些基础项。主机名必须是2.1里改完并重启后的名字不能还是安装前的旧名。时区不一致会让日志时间对不上排错时很别扭。改完点保存再刷新一次页面确认名称没有回退。4.2 选软件、更新选定软件、转至选项回到部署软件在可用软件里选AWC2406对应介质点“更新选定的软件”再确认已选软件列表里有正确内容。这里的动作顺序不能省先选、再更新、再核对、再转至选项。只选不点更新后面组件配置读不到介质选错版本组件状态会卡住。核对项期望值说明可用软件AWC2406与活动介质版本一致已选软件列表包含AWC2406不能为空或带旧版本更新动作已点击更新选定的软件未更新则组件读不到介质选项页已勾选对应选项按现场规范勾不照抄环境保存已保存环境选项不保存则生成脚本缺配置转至选项后勾选对应选项再保存环境选项。选项会影响生成脚本里的端口、认证和组件开关测试环境可以按最小可用勾生产要按规范来。勾完不要直接跳部署先回概述和软件页各刷一次确认选择没丢。页面之间来回切时偶尔会丢未保存状态血泪经验是每改一页就点一次保存。4.3 应用程序与组件的配置顺序应用程序页添加可用应用程序选择后点“更新选定的应用程序”再点“转至组件”。组件页按顺序配每个组件点开填详细信息状态到100%再下一个。输入里给的组件顺序可以作为清单但实际界面有依赖箭头时以箭头为准Database Server通常要先于Corporate Server完成连接测试不然后面组件会反复报数据库连不上。顺序组件配置重点1Active Workspace Client BuilderAWC构建参数、主机名2Active Workspace Gateway网关地址、端口3Corporate ServerTC服务端参数4Database ServerSQL主机、实例、库名、密码5FSC文件存储卷路径6FSC Group卷组配置7FSC Keys密钥相关配置8Indexer索引服务参数9Indexing Engine索引引擎连接10Licensing Server许可服务地址11Microservice Node微服务节点12Server Manager服务管理器13Server Manager Cluster Configuration集群配置14Teamcenter Web Tier (Java EE)Web层Java EE配置每个组件点右侧的展开按钮能看到更细的配置项填完保存再刷新状态从灰变黄再变绿。状态卡在90%左右时先看该组件日志和数据库连通性不要急着删环境重建。所有组件到100%后再点“转至部署”这时才会出现生成安装脚本的入口。组件没全绿就生成脚本后面deploy.bat大概率跑一半停。注意Database Server和TC的密码在Deployment Center里不允许! $ % ^ : ; . _ ( ) { }这些特殊符号TEM里允许带但环境配置阶段先统一用纯字母数字能避开大半密码类报错。5. 部署脚本与避坑排查deploy.bat参数、日志与五条翻车记录5.1 deploy.bat的参数与解压路径所有组件100%后点转至部署再点生成安装脚本。生成成功会给部署说明部署包在D:\DeploymentCenter\repository\deploy_scripts\Env_Tc\install下文件名形如deploy_XXX.zip。不要直接在install目录里双击解压先解到独立短路径再用管理员CMD进去跑。# 找到最新部署包并解压到短路径 $zip Get-ChildItem D:\DeploymentCenter\repository\deploy_scripts\Env_Tc\install\deploy_*.zip | Sort-Object LastWriteTime -Descending | Select-Object -First 1 Expand-Archive -Path $zip.FullName -DestinationPath D:\deploy\Env_Tc -Force逻辑说明按时间取最新部署包避免拿到旧环境生成的zip解压到D:\deploy\Env_Tc短路径减少bat内部路径拼接问题。参数说明deploy_*.zip匹配部署包命名-Force覆盖上次解压残留目标路径不要带空格和中文。解压后应能看到deploy.bat和配套目录。以管理员身份打开CMD进入解压路径再执行。下面命令里的账号密码是输入里给的示例值实际按环境改-softwareLocation必须指向存储库software目录不是介质解压子目录。:: 以管理员身份运行CMD不要双击bat cd /d D:\deploy\Env_Tc deploy.bat -dcusernamedcadmin -dcpassworddcadmin -softwareLocationD:\DeploymentCenter\repository\software逻辑说明cd /d先切盘符再切目录避免当前目录不对导致找不到配置deploy.bat带三个参数启动部署。参数说明-dcusername和-dcpassword是Deployment Center登录账号密码含特殊符号时先改成纯字母数字-softwareLocation是存储库software根路径末尾不要多写反斜杠。执行后不要关窗口控制台输出就是第一手排错信息。5.2 五条踩坑记录现象、原因、解决第一条添加介质一直失败界面只提示添加失败。现象是存储库列表刷不出活动介质repotool日志尾部出现解压异常。原因是介质解压路径太长或出现同名嵌套repotool扫描不到根目录。解决是把介质重新解到D:\DeploymentCenter\repository\software\AWC2406确保没有AWC2406\AWC2406嵌套再重新添加。第二条组件状态卡在90%左右Database Server反复报连接失败。现象是SQL端口通、账号也对但组件就是不过。原因是Database Server或TC密码里带了! $ %这类特殊符号Deployment Center校验不通过。解决是把密码改成纯字母数字重新填TEM里允许特殊符号不代表这里允许两个地方的规则要分开记。第三条deploy.bat一闪而过像没执行。现象是双击后窗口秒关部署日志也没生成。原因是没用管理员CMD或者解压路径带空格没加引号。解决是用管理员身份打开CMD先cd /d到解压目录再按完整参数执行路径有空格时给路径加英文双引号。第四条环境里选不到活动介质。现象是存储库明明有介质部署软件页可用软件为空。原因是介质版本和Deployment Center 2406不匹配或者添加后没刷新存储库缓存。解决是先核对介质版本再回存储库重新添加一次刷新页面后重新选软件仍不出现就看repotool日志里有没有版本识别失败。第五条AWC登录失败但TC服务看着都起来了。现象是浏览器打不开AWC或者打开后报网关错误。原因是hosts没覆盖全部主机名、防火墙没关或AWC网关端口没放行。解决是按2.1的对照表逐条ping主机名确认解析到IPv4测试环境确认防火墙已关生产按端口放行再用Test-NetConnection打网关端口。5.3 日志定位与复装前清理部署脚本跑失败时先找日志再动手重装。除了repotool日志部署包解压目录下也可能生成部署日志常见做法是先看控制台最后几十行再按时间搜当前目录的*.log。下面这条从存储库日志目录递归找最新五个日志适合确认是不是介质侧先出的问题。# 递归找最新日志先定位再打开 Get-ChildItem D:\DeploymentCenter\webserver\repotool\logs -Recurse -Filter *.log | Sort-Object LastWriteTime -Descending | Select-Object -First 5 FullName,LastWriteTime,Length逻辑说明递归覆盖子目录按时间倒序取前五个先锁定本次操作时间窗内的文件。参数说明-Recurse会进子目录-First 5可按需改Length为0时查服务账户写权限。打开日志后先搜ERROR和Exception再看错误前20行通常能看到触发动作。复装前不要直接删repository先把deploy_scripts\Env_Tc备份出来再停掉相关服务检查端口占用。下面这条查1433、8080、7001三个常见端口按实际环境改端口列表。# 查常见端口占用避免复装时端口冲突 Get-NetTCPConnection -State Listen | Where-Object {$_.LocalPort -in 1433,8080,7001} | Select-Object LocalAddress,LocalPort,OwningProcess逻辑说明只列监听状态找出占用端口的进程号再用Get-Process -Id确认是不是旧服务。参数说明-in后面的端口按现场实际改OwningProcess是PID不要直接杀进程先确认是不是SQL、TC或AWC相关服务。复装前把旧环境备份、端口清干净比装到一半再回头查省时间。6. 装完别急着交付三条验证线与一个复装习惯装完AWC2406后我一般按“服务、端口、登录”三条线验不靠界面上的100%就当成功。服务线看TC、AWC、SQL、License相关服务是否Running端口线从应用机打数据库1433、Web层和网关端口登录线用部署说明里给出的AWC地址实际登一次别只在本机浏览器缓存里点。验证线动作通过标准服务查TC、AWC、SQL、License服务关键服务Running启动类型自动端口从应用机打DB 1433、Web和网关端口TcpTestSucceeded为True登录用部署说明里的AWC地址登录能进登录页并完成一次认证服务检查可以用一条宽匹配先扫一遍再针对没起来的具体查。下面这条只做初筛匹配不到不代表没装按实际服务名补过滤词。# 初筛关键服务按实际服务名补充匹配词 Get-Service | Where-Object {$_.Status -eq Running -and $_.DisplayName -match teamcenter|active workspace|sql|license} | Format-Table Name,DisplayName,Status逻辑说明先看运行中的关键服务缩小排查范围没列出来的服务再单独查。参数说明-match里的词按现场显示名补Status -eq Running只列运行中停止的会漏掉需要单独查停止项。端口验证用Test-NetConnection逐条打别只在一台机器上测。复装习惯是我从几次返工里换来的每次装AWC2406前先把主机名、hosts、密码字符集三件事写进一张检查表装完把deploy_scripts\Env_Tc整个备份再把介质路径和部署包路径记在环境说明里。从那以后我每次点“生成安装脚本”之前都强制走一遍主机名解析、组件状态、密码字符集这三项不再凭记忆。希望帮到你。本文还有配套的精品资源点击获取