簡介針對Teamcenter AWC2406部署中的常見問題這份docx筆記整理了從環(huán)境準備、依賴服務(wù)安裝到Deployment Center配置、組件設(shè)置及生成部署腳本的完整操作流程適合負責TC實施或維護的工程師按圖索驥減少因主機名、網(wǎng)絡(luò)或組件配置錯誤導(dǎo)致的中途返工。資源僅1個文件格式為docx共4.67MB內(nèi)容以分步說明配以路徑提示為主重點提醒修改主機名、關(guān)閉防火墻與IPv6并完整給出JDK17.0.3、Siemens License Server、SQL Server 2019等前置安裝要求隨后通過Deployment Center介質(zhì)添加、環(huán)境創(chuàng)建、應(yīng)用程序與組件逐項配置覆蓋Active Workspace Client、Gateway、Corporate Server及Database Server等關(guān)鍵模塊同時強調(diào)數(shù)據(jù)庫與TC密碼禁用特殊符號等易忽略細節(jié)。目前已獲得312人學(xué)習尤其適合首次部署AWC2406、希望系統(tǒng)掌握安裝全流程的工程師。借助其中日志排錯思路、deploy.bat參數(shù)示例與運行命令可快速定位添加介質(zhì)失敗等問題顯著提升安裝成功率。1. Teamcenter Deployment Center 裝 AWC2406先把這條鏈跑順再動手AWC2406 的安裝難的不是點下一步而是十幾個組件之間的依賴關(guān)系。手動逐個裝 Active Workspace Client、Gateway、Corporate Server、Indexer 這些服務(wù)任何一步端口沖突或密碼解析出錯都要花半天時間排查。用 Teamcenter Deployment Center 2406 可以把「介質(zhì)入庫 → 環(huán)境建模 → 組件配置 → 腳本生成 → 一鍵部署」串成一條可控的鏈路這也是當前 Teamcenter 環(huán)境安裝 AWC 的主流方式。這篇文章面向剛接手 Teamcenter 環(huán)境、需要在干凈服務(wù)器上從零部署 AWC2406 的運維和實施工程師按實際操作順序拆解安裝準備、介質(zhì)入庫、組件配置到 deploy.bat 落地的全過程并把我在現(xiàn)場踩過的坑一并寫出來。2. 裝前準備三件事主機名、網(wǎng)絡(luò)策略與 JDK/License/數(shù)據(jù)庫順序2.1 修改主機名與 hosts 映射影響的是許可校驗和 URL 生成很多安裝教程會用黑色筆記把截圖里的主機名蓋住提示你改成自己的主機名。這一步看上去無關(guān)痛癢實際上它決定了后面 License Server 的許可校驗、Active Workspace Gateway 生成的訪問 URL、以及部署腳本里所有服務(wù)地址的正確性。如果裝機時主機名沒改到了部署階段才發(fā)現(xiàn)問題改完主機名后 Deploymen Center 生成的腳本里還殘留舊主機名只能重新生成環(huán)境非常被動。主機名的規(guī)范建議用小寫字母加數(shù)字比如 TcSrv01避免下劃線和過長名稱。修改完系統(tǒng)主機名后還要在 hosts 文件里補一條主機名到本機回環(huán)地址的映射防止許可服務(wù)做主機名反查時去請求不存在的 DNS。:: 1) 管理員身份打開記事本編輯 hosts 文件 notepad C:\Windows\System32\drivers\etc\hosts :: 2) 在文件末尾追加一行把主機名解析到本機 127.0.0.1 TcSrv01這里把 127.0.0.1 和主機名之間用 Tab 分隔不要用空格。加這一行的原因是 Teamcenter 的 License Server 在校驗許可時會做主機名解析如果 hosts 里沒有對應(yīng)記錄服務(wù)啟動會變慢甚至直接失敗。你有內(nèi)部 DNS 也可以不寫但多數(shù)實施環(huán)境的主機名解析不可控這種本地映射是最穩(wěn)妥的做法。改完 hosts 之后用hostname命令確認一下當前系統(tǒng)主機名輸出結(jié)果要和 hosts 里追加的名字一致。如果不一致說明系統(tǒng)主機名還沒改成功要重新設(shè)置并重啟。這一步先做對后面生成安裝腳本時 hostname 才會以正確值寫入所有配置文件。2.2 關(guān)閉防火墻與禁用 IPv6減少網(wǎng)絡(luò)層變量的干擾Deployment Center 在部署階段會啟動很多服務(wù)組件之間的通信端口非常多像 Corporate Server、Microservice Node、Indexing Engine 各自監(jiān)聽不同端口。如果開著 Windows 防火墻每漏一條放行規(guī)則部署過程就會在某一步突然失敗而且日志不一定直接提示防火墻攔截。所以我一般在內(nèi)網(wǎng)部署機上先把防火墻全部關(guān)閉等整套環(huán)境裝完、驗證通過之后再按實際端口列表把防火墻策略收緊到最小范圍。:: 關(guān)閉 Windows 防火墻的三個配置文件域、專用、公用 netsh advfirewall set allprofiles state off :: 禁用 IPv6 協(xié)議 netsh int ipv6 set state disabled第一條命令把域、專用、公用三種網(wǎng)絡(luò)配置文件的防火墻統(tǒng)一關(guān)閉避免后續(xù)服務(wù)綁定端口時被攔截。第二條禁用 IPv6 的原因比較玄學(xué)在 Windows Server 雙棧環(huán)境下SQL Server 和 Teamcenter 之間的 TCP 連接有時會解析到 IPv6 地址導(dǎo)致連接超時或報網(wǎng)絡(luò)不可達而服務(wù)本身配置的卻是 IPv4 地址。把 IPv6 直接禁掉能讓所有連接串老老實實走 IPv4 路徑。這個改動重啟服務(wù)器后完全生效因此建議在安裝 JDK 之前就把它設(shè)置好。需要留意的是禁用 IPv6 后要確認服務(wù)器的物理網(wǎng)卡配置沒有強制依賴 IPv6 協(xié)議否則重啟后可能出現(xiàn)網(wǎng)絡(luò)異常。對于一臺干凈的部署機來說這個風險一般是可控的。2.3 JDK 17.0.3、Siemens License Server 與 SQL Server 2019 的安裝順序安裝順序建議是JDK 17.0.3 → Siemens License Server → SQL Server 2019。JDK 必須放在最前面因為 Deployment Center 的 repotool 和后面 Indexing Engine 組件都依賴 Java 運行時JDK 版本不對介質(zhì)入庫時日志會直接報 UnsupportedClassVersionError。JDK 版本盡量用 17.0.3這是 AWC2406 構(gòu)建基線驗證過的版本用更新的 17.0.x 不一定有問題但復(fù)現(xiàn)教程場景時跟著原始版本走最穩(wěn)妥。:: 驗證 JDK 版本是否就位 java -version :: License Server 啟動后確認端口監(jiān)聽5099 是常見默認端口 netstat -ano | findstr 5099java -version輸出里應(yīng)能看到 17.0.3 字樣。License Server 安裝完成后把它手動啟動一次然后用 netstat 確認 5099 端口處于監(jiān)聽狀態(tài)。如果端口沒有起來先去看 Windows 服務(wù)列表里許可相關(guān)服務(wù)是否處于運行狀態(tài)以及許可證文件是否已經(jīng)成功導(dǎo)入。許可服務(wù)不要求開機自啟但建議設(shè)置為手動由部署腳本統(tǒng)一拉起。SQL Server 2019 的安裝要注意幾點認證模式選混合模式sa 密碼提前定好并且記下來這個密碼在后續(xù) Database Server 組件配置里會用到排序規(guī)則建議選 SQL_Latin1_General_CP1_CI_AS這是 Teamcenter 在英文環(huán)境下常用的配置所有庫都統(tǒng)一用這個排序規(guī)則避免查到一半出現(xiàn)字符串比較錯誤。安裝完成后到 SQL Server 配置管理器里確認 TCP/IP 協(xié)議已經(jīng)啟用否則后面 Database Server 組件連接數(shù)據(jù)庫時會報超時。這一步是很多新手容易漏掉的默認情況下 SQL Server 的 TCP/IP 可能是禁用狀態(tài)只開了命名管道部署腳本連接不上。3. 介質(zhì)入庫解壓路徑的選擇、repotool 日志與活動介質(zhì)確認3.1 解壓路徑盡量短為什么是 D:\DeploymentCenter\repository\softwareAWC2406 的安裝介質(zhì)要解壓到 Deployment Center 的軟件存儲庫目錄下即D:\DeploymentCenter\repository\software。Deployment Center 會掃描這個目錄來識別介質(zhì)。解壓后的介質(zhì)路徑要盡量短這個要求不是潔癖而是因為后續(xù)生成安裝腳本時會把介質(zhì)路徑拼接到各種配置文件和 deploy.bat 參數(shù)里。Windows 路徑默認 260 字符限制介質(zhì)目錄名太長或者嵌套層級太多腳本跑到一半就可能因為路徑超出限制直接中斷。# 在 Windows CMD 中執(zhí)行把介質(zhì)壓縮包解壓到軟件存儲庫目錄 tar -xf AWC2406_media.zip -C D:\DeploymentCenter\repository\softwareWindows Server 2019 自帶 tar 命令可以解壓 zip 格式的介質(zhì)包。-xf表示解壓文件-C指定目標目錄。解壓完成后確認目錄結(jié)構(gòu)是D:\DeploymentCenter\repository\software\介質(zhì)名并且介質(zhì)名下面直接是安裝文件清單不要再套一層同名目錄。如果介質(zhì)是 ISO 格式或分卷壓縮包可以先在臨時目錄解壓再把整體內(nèi)容復(fù)制到目標目錄效果一樣。還要注意介質(zhì)目錄本身的名字不要太長全路徑里不要出現(xiàn)空格和中文。Deployment Center 自身安裝路徑已經(jīng)是不帶空格的短路徑介質(zhì)如果放在D:\Deployment Center\repository\software這種帶空格的路徑里后續(xù)腳本解析時會出現(xiàn)各種奇怪的拼接錯誤。3.2 添加失敗先看 repotool 日志別靠猜介質(zhì)解壓完登錄 Deployment Center 后軟件存儲庫里沒看到活動介質(zhì)這種問題很常見。不要急著反復(fù)點刷新先去日志目錄里找原因。Deployment Center 的介質(zhì)掃描工具 repotool 會把入庫過程的關(guān)鍵信息寫到D:\DeploymentCenter\webserver\repotool\logs下這里的日志是排查添加介質(zhì)失敗現(xiàn)場的第一手材料。:: 查看 repotool 日志文件內(nèi)容 type D:\DeploymentCenter\webserver\repotool\logs\repotool.log :: 只過濾 ERROR 級別的日志行 findstr /i error D:\DeploymentCenter\webserver\repotool\logs\repotool.logtype命令會輸出整個日志文件適合日志體積小的時候用。如果日志文件很大用 findstr 過濾 error 關(guān)鍵字更高效。日志里常見兩類信息一類是Invalid media或者介質(zhì)結(jié)構(gòu)無法識別說明解壓后的目錄層級不對Deployment Center 沒有找到它期望的標志性文件另一類是權(quán)限相關(guān)錯誤說明當前解壓的目錄權(quán)限沒有給到 Deployment Center 的 Web 服務(wù)賬號。提示介質(zhì)解壓完成后不要立即刷新頁面等 30 秒左右再操作。repotool 的目錄掃描是按周期觸發(fā)的不是實時監(jiān)聽。如果日志里找不到任何錯誤但存儲庫依然為空可以嘗試重啟 Deployment Center 的 Web 服務(wù)進程再刷新頁面。介質(zhì)掃描服務(wù)偶爾會陷入不重新加載目錄的僵死狀態(tài)重啟后一般就能恢復(fù)正常。3.3 登錄 Deployment Center 確認活動介質(zhì)狀態(tài)介質(zhì)入庫成功后登錄 Deployment Center 的 Web 管理界面在軟件存儲庫頁面應(yīng)該能看到剛添加的介質(zhì)狀態(tài)顯示為活動。這一步確認很重要介質(zhì)只有處于活動狀態(tài)才會出現(xiàn)在后續(xù)環(huán)境創(chuàng)建的候選列表里。Deployment Center 2406 在一個環(huán)境里同時只允許一個活動介質(zhì)參與構(gòu)建避免多版本介質(zhì)互相覆蓋。如果環(huán)境里同時存在多個介質(zhì)的舊記錄建議把不需要的介質(zhì)先停用或移除再進行環(huán)境創(chuàng)建。這里也需要確認你當前用的登錄賬號有足夠的操作權(quán)限。默認的管理賬號是 dcadmin如果這個賬號密碼被改過后面 deploy.bat 傳參時也要用對應(yīng)的新密碼否則會認證失敗。介質(zhì)活動狀態(tài)確認沒問題后就可以進入環(huán)境創(chuàng)建和組件配置階段了。4. 環(huán)境與組件配置Env_Tc、密碼規(guī)則與組件順序的價值4.1 創(chuàng)建環(huán)境 Env_Tc環(huán)境名決定腳本輸出目錄登錄 Deployment Center 后點擊創(chuàng)建環(huán)境進入環(huán)境后先在概述里修改環(huán)境名稱教程里的示例叫 Env_Tc。環(huán)境名稱不是隨便起的它會直接影響后續(xù)部署腳本的輸出路徑D:\DeploymentCenter\repository\deploy_scripts\Env_Tc\install。如果環(huán)境名里帶空格或特殊符號生成的腳本目錄和 deploy.bat 的路徑拼接都會出問題。環(huán)境名用途對應(yīng)腳本目錄Env_Tc正式部署環(huán)境D:\DeploymentCenter\repository\deploy_scripts\Env_Tc\installEnv_Test測試驗證環(huán)境D:\DeploymentCenter\repository\deploy_scripts\Env_Test\install環(huán)境名建議用字母加下劃線的組合例如 Env_Tc、Env_Prod_01。創(chuàng)建完環(huán)境后左側(cè)導(dǎo)航會出現(xiàn)環(huán)境相關(guān)操作入口接下來需要把剛才入庫的介質(zhì)關(guān)聯(lián)到這個環(huán)境下。4.2 更新選定的軟件與保存環(huán)境選項勾什么決定后面出現(xiàn)什么在部署軟件頁面里可用軟件列表會列出當前環(huán)境可以關(guān)聯(lián)的介質(zhì)。選擇剛才入庫的 AWC2406 介質(zhì)點擊「更新選定的軟件」這一步會把介質(zhì)中的軟件包信息同步到當前環(huán)境。同步完成后在「已選軟件」里確認列出的內(nèi)容正確再點「轉(zhuǎn)至選項」。選項頁面里有一系列部署相關(guān)的開關(guān)我一般勾選與 AWC 客戶端訪問相關(guān)的常規(guī)選項調(diào)試類選項保持默認不勾。你在這里勾選的內(nèi)容會直接影響下一步「組件」頁面里列出哪些組件條目。如果后續(xù)發(fā)現(xiàn)某個組件沒有出現(xiàn)在列表里回頭檢查選項這一步是不是漏勾了相關(guān)內(nèi)容。保存環(huán)境選項后回到部署軟件頁面重新確認一次選中的軟件狀態(tài)確保沒有因為選項變更導(dǎo)致軟件包被反選。這一階段所有操作的結(jié)果都會被 Deployment Center 記錄后續(xù)生成安裝腳本時會基于這套配置生成部署包所以每一步保存后最好都確認一下頁面狀態(tài)。4.3 組件配置順序、詳細配置入口與密碼規(guī)則決定成敗的三件事組件配置是整條鏈路里最容易翻車的環(huán)節(jié)。界面上按順序列出的組件包括 Active Workspace Client Builder、Active Workspace Gateway、Corporate Server、Database Server、FSC、FSC Group、FSC Keys、Indexer、Indexing Engine、Licensing Server、Microservice Node、Server Manager、Server Manager Cluster Configuration、Teamcenter Web Tier (Java EE)。每個組件名稱右側(cè)都有展開查看更詳細配置信息的入口里面包括端口號、JVM 參數(shù)、依賴的服務(wù)地址等。默認值一般夠用除非當前端口被占用否則不需要逐個改動。組件之間的依賴關(guān)系決定了配置順序Indexing Engine 依賴 FSC Keys 生成的密鑰Server Manager Cluster Configuration 必須等 Server Manager 基礎(chǔ)配置完成后再處理Teamcenter Web Tier (Java EE) 放最后因為它依賴 Corporate Server 暴露的服務(wù)端口。所以我每次配置都嚴格按界面順序從上往下走不跳著配。組件主要職責配置注意點Active Workspace Client Builder生成客戶端構(gòu)建確認版本與介質(zhì)一致Active Workspace Gateway網(wǎng)關(guān)服務(wù)主機名不能填錯Corporate Server企業(yè)級服務(wù)端口和依賴地址Database Server數(shù)據(jù)庫連接配置密碼禁止特殊符號FSC / FSC Group / FSC Keys文件存儲與密鑰路徑盡量短Indexer / Indexing Engine索引服務(wù)依賴 FSC KeysLicensing Server許可服務(wù)指向指向已裝的 License ServerMicroservice Node微服務(wù)節(jié)點端口不沖突Server Manager / Cluster服務(wù)管理與集群先單機后集群Teamcenter Web Tier (Java EE)Web 層服務(wù)最后配置密碼規(guī)則是這里最需要注意的約束。配置 Database Server 以及 Teamcenter 相關(guān)密碼時不允許出現(xiàn)特殊符號包括 ! $ % ^ : ; . _ ( ) { } 這二十多個字符。TEMTeamcenter Engineering Manager則允許帶特殊符號。# 合規(guī)示例TcDb2024xYz字母加數(shù)字無特殊符號 # 違規(guī)示例TcDb2024包含 符號腳本解析時會被拆成多個參數(shù)為什么 Database Server 和 Teamcenter 的密碼卡得這么死因為這些密碼最終會寫進 Deployment Center 自動生成的 XML 配置和 deploy.bat 腳本里。腳本解析時 會被當作參數(shù)分隔符 會被當作命令連接符分號和尖括號也有各自的特殊含義一旦密碼里出現(xiàn)這些字符生成的腳本執(zhí)行時就會把密碼拆開導(dǎo)致認證失敗。與其在腳本里做各種轉(zhuǎn)義不如直接用字母加數(shù)字的組合密碼省掉一整類問題。TEM 允許特殊符號是因為 TEM 的密碼走的是另一條加密鏈路不經(jīng)過這個腳本解析器。所以在設(shè)計密碼時不要把 TC、Database Server 和 TEM 統(tǒng)一用一個模板分開設(shè)置并記錄在密碼管理工具里否則后面排查問題時很難判斷是哪個服務(wù)的密碼出了問題。5. 避坑排查Deployment Center 部署中我踩過的五個典型翻車現(xiàn)場5.1 介質(zhì)解壓了存儲庫列表還是空白這種現(xiàn)象很常見介質(zhì)解壓到 software 目錄repotool 日志里沒有 ERROR但刷新存儲庫列表就是空白。原因大概率是解壓出來的目錄權(quán)限沒給足Deployment Center 的 Web 服務(wù)賬號沒有權(quán)限讀取介質(zhì)目錄。解決方法是給軟件存儲庫目錄添加當前部署用戶的讀取權(quán)限或者直接用管理員身份重新解壓一次介質(zhì)讓目錄繼承默認的管理員權(quán)限。給完權(quán)限后等一輪掃描周期再刷新頁面一般就能看到活動介質(zhì)。5.2 組件狀態(tài)卡在 90%一直不到 100%我在模擬項目 X 的部署中遇到過一次Indexing Engine 組件狀態(tài)停在 90%等了十分鐘也沒變化。檢查發(fā)現(xiàn)是密碼里帶了一個 符號Deployment Center 保存配置時沒有拒絕但組件依賴處理時解析失敗狀態(tài)機掛起。解決方法是把密碼改成字母加數(shù)字組合回到部署軟件頁面重新更新軟件再進組件頁面逐項保存。不需要刪除環(huán)境重來改完密碼重新走一遍更新流程就能恢復(fù)。5.3 deploy.bat 執(zhí)行時報 dcusername 或 dcpassword 認證失敗這個問題通常出現(xiàn)在生成安裝腳本后的執(zhí)行階段?，F(xiàn)象是腳本運行到一半控制臺提示認證失敗并帶著 dcadmin 的用戶名。原因是 Deployment Center 的管理員賬號密碼不是默認值或者創(chuàng)建環(huán)境時使用的根本不是 dcadmin。解決方法是先用瀏覽器登錄 Deployment Center 頁面確認管理員賬號和密碼再用正確的參數(shù)去跑 deploy.bat。不要試圖在 bat 里做雙重轉(zhuǎn)義繞過認證那樣只會讓問題更隱蔽。5.4 Database Server 組件連不上 SQL Server部署腳本執(zhí)行到數(shù)據(jù)庫初始化步驟時報 SQL 連接超時多半是 SQL Server 的 TCP/IP 協(xié)議沒有啟用。SQL Server 安裝后默認可能只開了共享內(nèi)存和命名管道TCP/IP 處于禁用狀態(tài)部署腳本通過網(wǎng)絡(luò)協(xié)議連接數(shù)據(jù)庫自然失敗。解決方法是到 SQL Server 配置管理器中啟用 TCP/IP 協(xié)議確認監(jiān)聽端口固定為 1433然后重啟 SQL Server 服務(wù)。另外檢查一下 sa 密碼里有沒有特殊符號如果帶 或分號連接串解析同樣會出問題。5.5 安裝腳本生成成功但部署包 deploy_XXX.zip 找不到這種現(xiàn)象出現(xiàn)在生成腳本階段點擊生成安裝腳本提示成功系統(tǒng)也彈出了部署說明但在 install 目錄下沒找到對應(yīng)的 zip 包。原因通常是當前瀏覽的界面環(huán)境不是生成腳本時的那個環(huán)境環(huán)境名對不上導(dǎo)致部署包生成了不在你預(yù)期目錄下或者是瀏覽器彈出了下載窗口壓縮包被下載到了用戶下載目錄。解決方法是仔細看部署說明里提示的路徑信息以它為準。如果是瀏覽器下載行為就把壓縮包另存到與 install 目錄同級的位置文件名保持 deploy_XXX.zip 不變不要重命名。6. 生成安裝腳本與 deploy.bat 執(zhí)行從組件 100% 到部署完成所有組件狀態(tài)都變成 100% 后點擊轉(zhuǎn)至部署再點擊生成安裝腳本。腳本生成成功后會提示部署說明里面包含部署包 deploy_XXX.zip 的位置默認在D:\DeploymentCenter\repository\deploy_scripts\Env_Tc\install目錄下。把這個 zip 包解壓到一個路徑較短的位置比如D:\Deploy\Env_Tc然后以管理員身份打開 CMD進入解壓后的目錄執(zhí)行部署命令。deploy.bat -dcusernamedcadmin -dcpassworddcadmin -softwareLocationD:\DeploymentCenter\repository\software-dcusername和-dcpassword是 Deployment Center 的管理員賬號密碼要和之前登錄 Web 界面用的賬號一致。-softwareLocation指向介質(zhì)解壓根目錄也就是軟件存儲庫路徑告訴部署腳本到哪個位置去讀取安裝介質(zhì)內(nèi)容。執(zhí)行之前先確認當前目錄確實是解壓出來的部署包根目錄用 dir 命令看一眼再運行。部署過程會持續(xù)一段時間結(jié)束后可以用服務(wù)列表或端口監(jiān)聽來驗證關(guān)鍵組件是否起來。:: 驗證 AWC 相關(guān)服務(wù)是否啟動 sc query | findstr /i AWC Gateway從那以后我每次生成安裝腳本前都會強制走一遍檢查流程所有組件狀態(tài)是否為 100%、Database Server 和 TC 密碼是否帶禁用符號、主機名是否與 hosts 一致、部署包是否在預(yù)期目錄。這套檢查流程幫我擋掉了好幾次半夜部署翻車的風險。希望幫到你。本文還有配套的精品資源點擊獲取