戰(zhàn):從環(huán)境準(zhǔn)備到部署腳本全解析)
簡介圍繞Teamcenter AWC2406的安裝實(shí)踐整理了一份基于Deployment Center部署的完整操作筆記主要面向?qū)嵤┕こ處熍c系統(tǒng)管理員幫助規(guī)避安裝過程中常見的環(huán)境沖突與配置盲點(diǎn)。資源為單個docx文檔壓縮包大小4.67MB內(nèi)容按安裝流程分步展開從修改主機(jī)名、關(guān)閉防火墻與IPv6到安裝JDK17.0.3、Siemens License Server和SQL Server 2019再到通過Deployment Center添加介質(zhì)、創(chuàng)建環(huán)境與組件配置最后生成部署腳本并執(zhí)行deploy.bat。文檔還特別提示了Database Server與TC密碼不允許包含特殊符號、TEM支持特殊符號等易錯細(xì)節(jié)并給出介質(zhì)添加失敗時的日志排查路徑具備較強(qiáng)的實(shí)操參考價值。已有312人學(xué)習(xí)適合需要按步驟完成AWC2406環(huán)境搭建或進(jìn)行同類Teamcenter部署的讀者對照使用。1. 用 Deployment Center 裝 AWC2406從介質(zhì)入庫到部署腳本落地的全景圖用 Deployment Center 安裝 AWC2406很多人第一次上手都會卡在同一個地方明明介質(zhì)放進(jìn)存儲庫了環(huán)境也建了最后跑 deploy.bat 卻一路報錯對著日志干瞪眼。這篇筆記把整套流程拆成可復(fù)現(xiàn)的步驟從改主機(jī)名、關(guān)防火墻、禁 IPv6到 JDK 17.0.3、License Server 4、SQL Server 2019 三個基礎(chǔ)組件再到介質(zhì)入庫、組件配置和腳本生成最后落到部署命令和驗證方法。適合剛接手 Teamcenter 環(huán)境搭建的運(yùn)維和實(shí)施工程師也適合被現(xiàn)場各種奇怪報錯折騰過的熟手對照排查。本文只講安裝參考更細(xì)節(jié)的內(nèi)容請以官方文檔為準(zhǔn)。2. 環(huán)境準(zhǔn)備的四件事主機(jī)名、防火墻、IPv6 與 JDK/License/數(shù)據(jù)庫AWC2406 這套東西對環(huán)境的敏感程度超出多數(shù)人的預(yù)期。很多部署失敗并不是配置步驟錯了而是環(huán)境里某個基礎(chǔ)項沒對齊。下面這幾件事按先后順序做別跳。2.1 hosts 與主機(jī)名先改掉再動別的安裝文檔里主機(jī)名被黑色筆記覆蓋了改成自己的即可。這里的核心邏輯是Deployment Center 在生成部署腳本時會把當(dāng)前主機(jī)名寫進(jìn)各組件的配置文件中后續(xù)服務(wù)間通信全靠這個名稱去找機(jī)器。如果機(jī)器名和 hosts 里的解析對不上裝完的服務(wù)會互相找不到對方。先確認(rèn)當(dāng)前主機(jī)名再編輯 hosts 文件# 查看當(dāng)前主機(jī)名 hostname # 查看本機(jī) IP找 IPv4 地址那段 ipconfig /all # 以管理員身份打開記事本編輯 hosts 文件 notepad C:\Windows\System32\drivers\etc\hosts在 hosts 文件末尾追加一行格式是“IP 主機(jī)名”例如192.168.1.100 tc-server追加完保存然后在 CMD 里執(zhí)行ping tc-server能解析到本機(jī) IP 就說明生效了。這里要注意三點(diǎn)主機(jī)名里不要帶下劃線、空格和特殊字符Deployment Center 生成的腳本里主機(jī)名是直接拼進(jìn)路徑和連接字符串的帶下劃線會出現(xiàn)玄學(xué)問題hosts 里不要出現(xiàn)兩個不同 IP 指向同一主機(jī)名如果這臺機(jī)器后續(xù)會加入域提前確認(rèn)主機(jī)名和域賬號的對應(yīng)關(guān)系裝完再改主機(jī)名屬于給自己挖坑。2.2 關(guān)防火墻、禁 IPv6網(wǎng)絡(luò)層面的兩個開關(guān)SQL Server 2019、License Server、TC 服務(wù)之間走的是主機(jī)名解析和動態(tài)端口防火墻策略沒有放行會直接超時。IPv6 的問題更隱蔽主機(jī)名優(yōu)先解析到 IPv6 地址而服務(wù)監(jiān)聽的是 IPv4結(jié)果就是連接被拒或反復(fù)超時。在隔離的內(nèi)網(wǎng)實(shí)施環(huán)境里常規(guī)做法是先把防火墻和 IPv6 都關(guān)掉等部署驗證通過后再按安全要求補(bǔ)白名單。# 關(guān)閉防火墻域/專用/公用三檔一起關(guān)僅限內(nèi)網(wǎng)實(shí)施環(huán)境 Set-NetFirewallProfile -Profile Domain,Public,Private -Enabled False # 禁用 IPv6DisabledComponents 設(shè)為 0xFF 表示全接口禁用 Set-ItemProperty -Path HKLM:\SYSTEM\CurrentControlSet\Services\Tcpip6\Parameters -Name DisabledComponents -Value 0xFF # 改完注冊表需要重啟系統(tǒng)才生效其中DisabledComponents的0xFF是禁用所有 IPv6 接口的常規(guī)取值重啟后可以在 CMD 里執(zhí)行ipconfig查看IPv6 地址不再出現(xiàn)就是成功了。注意公網(wǎng)或生產(chǎn)環(huán)境不要關(guān)防火墻這里只針對隔離的實(shí)施環(huán)境。如果現(xiàn)場不允許關(guān)防火墻至少放行 SQL Server 的 1433 端口、License Server 的監(jiān)聽端口以及 TC 服務(wù)之間的動態(tài)端口范圍否則后面組件狀態(tài)會一直卡著不動。2.3 JDK 17.0.3、License Server 與 SQL Server 2019版本別亂動這三個基礎(chǔ)組件是后面一切的前提。JDK 版本必須對齊 JDK 17.0.3不要隨手升級小版本AWC2406 對 JDK 版本有具體校驗版本不對時組件配置階段會直接報錯。License Server 4 負(fù)責(zé) TC 的授權(quán)服務(wù)服務(wù)必須處于啟動狀態(tài)端口不能被占用。SQL Server 2019 承擔(dān)數(shù)據(jù)庫角色建議在安裝時選擇混合認(rèn)證模式因為 Deployment Center 后續(xù)建環(huán)境要用 SQL 賬號去連庫。JDK 配置的常見做法是設(shè)置 JAVA_HOME并把%JAVA_HOME%\bin追加到 Path# 命令行設(shè)置 JAVA_HOMEsetx 只對之后新開的窗口生效 setx JAVA_HOME D:\JDK17.0.3 # Path 建議到系統(tǒng)屬性 - 環(huán)境變量里手動追加 %JAVA_HOME%\bin # 新開一個 CMD 驗證版本必須是 17.0.3 java -version不推薦用setx PATH的方式改 Pathsetx 會把變量值整體覆蓋存在截斷風(fēng)險。SQL Server 2019 安裝時記住實(shí)例名、端口和排序規(guī)則Deployment Center 組件配置頁里要填的就是這些信息。License Server 裝完先確認(rèn)服務(wù)是“正在運(yùn)行”點(diǎn)擊服務(wù)管理器里能看到對應(yīng)服務(wù)狀態(tài)。三件套全部就緒后再進(jìn)入介質(zhì)入庫環(huán)節(jié)。3. 介質(zhì)入庫解壓路徑、活動介質(zhì)與 repotool 日志排查介質(zhì)入庫是 Deployment Center 安裝流程里第一個真正會卡人的環(huán)節(jié)。這一步做不好后面的環(huán)境創(chuàng)建、組件配置全都沒法進(jìn)行。3.1 解壓介質(zhì)路徑盡量短是硬要求安裝介質(zhì)需要解壓后放到D:\DeploymentCenter\repository\software目錄下路徑要盡量短。這背后的原因是Deployment Center 在解析介質(zhì)、讀取產(chǎn)品定義文件時會把完整路徑拼進(jìn)內(nèi)部命令Windows 對路徑長度有限制路徑過長時介質(zhì)掃描會失敗甚至介質(zhì)文件拷貝到存儲庫時會中途斷掉。我一般會把介質(zhì)解壓成類似D:\DeploymentCenter\repository\software\AWC2406這樣一層結(jié)構(gòu)不要讓介質(zhì)目錄嵌套太深。比如某個介質(zhì)解壓出來是D:\DeploymentCenter\repository\software\AW2406\product\disk1是正常的但如果變成D:\DeploymentCenter\repository\software\install\packages\AWC2406\2024\disk1就太深了建議重新整理。另外一個容易被忽略的點(diǎn)是路徑里的字符。介質(zhì)目錄和上級目錄都不要出現(xiàn)中文、空格和這類特殊符號Deployment Center 內(nèi)部腳本對路徑的解析比較原始空格會直接導(dǎo)致介質(zhì)識別失敗。解壓時右鍵選擇“解壓到當(dāng)前文件夾”保持目錄結(jié)構(gòu)完整不要只拷貝部分文件。3.2 登錄 Deployment Center 添加介質(zhì)失敗先看 repotool 日志介質(zhì)放進(jìn) software 目錄后打開瀏覽器登錄 Deployment Center進(jìn)入“軟件存儲庫”正常情況下能看到剛放入的介質(zhì)顯示為活動狀態(tài)。這一步的原理是 Deployment Center 會周期性掃描倉庫目錄把識別到的產(chǎn)品定義讀入存儲庫列表所以介質(zhì)結(jié)構(gòu)不完整或路徑異常時列表里就是空的。如果添加失敗不要反復(fù)試去D:\DeploymentCenter\webserver\repotool\logs目錄下看日志。日志文件里記錄了掃描介質(zhì)的詳細(xì)過程包括讀取了哪個目錄、為什么判定介質(zhì)無效。常見原因有三個介質(zhì)目錄訪問權(quán)限不足、解壓過程中文件缺失、路徑過長。# 切換到 repotool 日志目錄 cd /d D:\DeploymentCenter\webserver\repotool\logs # 查看最近的日志文件按修改時間排序 dir /o-d日志里如果出現(xiàn)“access denied”或“permission denied”字樣是權(quán)限問題確認(rèn)當(dāng)前賬號對D:\DeploymentCenter\repository\software有完全控制權(quán)。如果出現(xiàn)“invalid product definition”或“file not found”說明解壓不完整或介質(zhì)目錄結(jié)構(gòu)被改過回到 3.1 重新解壓。如果日志里提示路徑過長把介質(zhì)挪到更短路徑后再掃描一次。注意介質(zhì)添加成功后存儲庫里顯示的是“活動介質(zhì)”。如果狀態(tài)不是活動而是“無效”或“錯誤”說明介質(zhì)本身有問題不要繼續(xù)往下走。4. 環(huán)境與組件配置軟件更新、十六個組件和密碼符號限制環(huán)境配置是 Deployment Center 安裝流程的核心環(huán)節(jié)耗時長也是報錯集中區(qū)。整個流程可以拆成環(huán)境創(chuàng)建、軟件更新、選項保存、應(yīng)用程序配置、組件配置五個步驟順序不要打亂。4.1 創(chuàng)建環(huán)境并改名Env_Tc 從哪改登錄 Deployment Center 后先創(chuàng)建一個新環(huán)境然后進(jìn)入環(huán)境的“概述”頁面把名稱改成類似Env_Tc這樣的自定義名字。環(huán)境名會直接出現(xiàn)在后續(xù)生成的部署包文件名里比如deploy_Env_Tc.zip取一個好認(rèn)的名字方便后期分辨多個部署環(huán)境。環(huán)境創(chuàng)建完成后左側(cè)導(dǎo)航會切換到這個環(huán)境的工作區(qū)。改名這一步很多人會跳過但默認(rèn)環(huán)境名在生產(chǎn)環(huán)境里有多個部署包時完全分不清建議第一時間改掉。改完保存環(huán)境名在后續(xù)所有步驟里都會用上。4.2 軟件更新與環(huán)境選項先刷新再勾選回到“部署軟件”頁面這一步的作用是把存儲庫里的介質(zhì)關(guān)聯(lián)到當(dāng)前環(huán)境。先在“可用軟件”里找到對應(yīng)介質(zhì)并勾選點(diǎn)擊“更新選定的軟件”Deployment Center 會把介質(zhì)關(guān)聯(lián)到當(dāng)前環(huán)境并同步產(chǎn)品信息。更新完成后確認(rèn)“已選軟件”列表里有正確內(nèi)容再點(diǎn)擊“轉(zhuǎn)至選項”。# 這一步?jīng)]有命令行操作但注意觀察界面上的狀態(tài)變化 # 更新完成后已選軟件列表必須出現(xiàn)介質(zhì)名稱如果“已選軟件”是空的說明介質(zhì)沒有正確關(guān)聯(lián)返回存儲庫確認(rèn)介質(zhì)狀態(tài)不要強(qiáng)行走下去。進(jìn)入“選項”頁后勾選需要的安裝選項然后保存環(huán)境選項。有些選項之間是聯(lián)動關(guān)系勾選主選項后子選項會自動帶出。保存環(huán)境選項時如果報錯優(yōu)先檢查是不是密碼字段里帶了特殊符號這條見 4.4。4.3 應(yīng)用程序與組件清單十六個組件按順序過在“應(yīng)用程序”里可以添加可用的應(yīng)用程序選中后點(diǎn)擊“更新選定的應(yīng)用程序”再點(diǎn)擊“轉(zhuǎn)至組件”。組件配置是整個流程里最耗時的部分需要按順序逐個配置各組件的詳細(xì)信息。點(diǎn)組件行后面的詳情圖標(biāo)能看到更詳細(xì)的配置項包括主機(jī)名、端口、服務(wù)賬號、數(shù)據(jù)庫連接信息等。AWC2406 的組件清單一共十六個按界面里的順序逐個過組件名配置要點(diǎn)Active Workspace Client BuilderWeb 客戶端構(gòu)建一般保持默認(rèn)Active Workspace Gateway網(wǎng)關(guān)服務(wù)確認(rèn)主機(jī)名與端口Corporate Server企業(yè)服務(wù)注意服務(wù)賬號Database Server數(shù)據(jù)庫連接信息密碼不允許特殊符號FSC文件服務(wù)控制器確認(rèn)共享目錄FSC Group文件服務(wù)組按現(xiàn)場規(guī)范配置FSC Keys文件服務(wù)密鑰與 FSC 對應(yīng)Indexer索引器關(guān)注內(nèi)存分配Indexing Engine索引引擎確認(rèn)全文檢索范圍Licensing Server授權(quán)服務(wù)指向 License Server 地址Microservice Node微服務(wù)節(jié)點(diǎn)資源占用較大Server Manager服務(wù)管理器確認(rèn)服務(wù)注冊方式Server Manager Cluster Configuration服務(wù)管理集群配置與 Server Manager 聯(lián)動Teamcenter Web Tier (Java EE)Web 層對 JDK 版本敏感每個組件配置完成后界面上的狀態(tài)值會更新。組件配置頁里填的主機(jī)名一定要和 2.1 里 hosts 配置的一致填 IP 或填別名都可能造成安裝后的服務(wù)間通信異常。4.4 密碼里的特殊符號黑名單連 . 和 _ 都不行這是整套安裝流程里最容易翻車的地方。Deployment Center 中配置 Database Server 以及 TC 的密碼時不允許出現(xiàn)! $ % ^ : ; . _ ( ) { }這些特殊符號。注意這個黑名單里包括_和.這兩個符號在大多數(shù)系統(tǒng)里被認(rèn)為是安全字符但在這里明確不行。# 密碼示例合法 # TcAdmin2024 # 密碼示例不合法會報錯 # Tc_Admin_2024 # Tc.Admin2024這條限制的坑在于你在環(huán)境選項或組件配置頁面輸入含特殊符號的密碼界面上可能不會立刻報錯而是在保存環(huán)境選項時給一個模糊的錯誤提示或者到組件配置階段 Database Server 連接失敗?,F(xiàn)場排查時容易繞到數(shù)據(jù)庫服務(wù)本身的問題上實(shí)際就是密碼格式不合法。TEM 是個例外它允許帶特殊符號。所以不要用同一套密碼邏輯去套所有組件Database Server 和 TC 的密碼用純字母數(shù)字組合最穩(wěn)妥TEM 的密碼可以單獨(dú)設(shè)計。4.5 組件狀態(tài)到 100%生成腳本前最后一道檢查所有組件配置完成后逐個確認(rèn)狀態(tài)值都變成 100%。這一步不能急任何一個組件不是 100%點(diǎn)擊“轉(zhuǎn)至部署”生成的腳本都有可能缺內(nèi)容裝到一半報錯再回來看就晚了。確認(rèn)全部 100% 后點(diǎn)擊“轉(zhuǎn)至部署”再點(diǎn)擊“生成安裝腳本”。生成成功后系統(tǒng)會提示部署說明里面有部署包的存放位置和解壓路徑。部署包一般位于D:\DeploymentCenter\repository\deploy_scripts\Env_Tc\install目錄下文件名類似deploy_XXX.zip其中 XXX 對應(yīng)環(huán)境名。5. 踩坑排查介質(zhì)失敗、空列表與 deploy.bat 報錯的四個現(xiàn)場下面四類問題是我在部署現(xiàn)場和虛擬機(jī)上反復(fù)踩過的按“現(xiàn)象 → 原因 → 解決”的結(jié)構(gòu)整理遇到類似報錯可以直接對照。5.1 介質(zhì)添加失敗存儲庫看不到活動介質(zhì)現(xiàn)象介質(zhì)文件已經(jīng)復(fù)制到D:\DeploymentCenter\repository\software目錄登錄 Deployment Center 后在軟件存儲庫中看不到任何活動介質(zhì)刷新也沒有反應(yīng)。原因介質(zhì)所在目錄權(quán)限不足或者解壓過程中文件缺失另一個高頻原因是路徑過長導(dǎo)致掃描進(jìn)程讀取介質(zhì)定義文件時中斷。解決先看D:\DeploymentCenter\webserver\repotool\logs下的日志。權(quán)限問題就給當(dāng)前賬號授予 repository 目錄的完全控制權(quán)路徑問題就把介質(zhì)挪到更短的路徑下重新掃描。5.2 已選軟件為空無法進(jìn)入選項頁現(xiàn)象在“部署軟件”頁面勾選介質(zhì)后點(diǎn)擊“更新選定的軟件”回到頁面一看“已選軟件”列表還是空的“轉(zhuǎn)至選項”按鈕無法點(diǎn)擊。原因介質(zhì)沒有正確關(guān)聯(lián)到當(dāng)前環(huán)境。常見是介質(zhì)入庫時未被識別為可部署軟件或者介質(zhì)的版本與 Deployment Center 2406 不匹配。解決回到軟件存儲庫確認(rèn)介質(zhì)狀態(tài)是“活動”把介質(zhì)解壓到短路徑后重新執(zhí)行更新操作。如果介質(zhì)文件本身來自非官方渠道先檢查解壓后的結(jié)構(gòu)里是否存在產(chǎn)品定義文件缺失的話需要重新獲取完整介質(zhì)。5.3 密碼含 . 或 _ 導(dǎo)致環(huán)境選項保存報錯現(xiàn)象環(huán)境選項填寫階段密碼字段里用了類似Tc_Admin_2024的寫法點(diǎn)擊保存環(huán)境選項時報錯提示信息比較籠統(tǒng)不指向具體字段。原因Database Server 和 TC 的密碼不允許特殊符號黑名單里包含_和.這兩個字符在多數(shù)系統(tǒng)里合法容易忽視。解決把密碼改為純字母數(shù)字組合比如TcAdmin2024重新保存。TEM 的密碼允許特殊符號不要被這條限制影響到 TEM 環(huán)境配置。5.4 deploy.bat 報錯找不到軟件位置現(xiàn)象解壓部署包后以管理員身份運(yùn)行 CMD 執(zhí)行deploy.bat -dcusernamedcadmin -dcpassworddcadmin -softwareLocationD:\DeploymentCenter\repository\software提示找不到軟件源或某個介質(zhì)不存在。原因-softwareLocation參數(shù)指向了具體介質(zhì)子目錄而不是介質(zhì)倉庫根目錄。腳本要求這個路徑下直接是各個介質(zhì)文件夾如果填成D:\DeploymentCenter\repository\software\AWC2406腳本會往下找找不到正確介質(zhì)。解決確認(rèn)-softwareLocation參數(shù)值為D:\DeploymentCenter\repository\software同時檢查盤符、目錄名是否完全一致注意路徑里不要有結(jié)尾反斜杠。6. 部署執(zhí)行與驗證deploy.bat 參數(shù)和一條確認(rèn)鏈路部署包生成成功后在D:\DeploymentCenter\repository\deploy_scripts\Env_Tc\install目錄下找到deploy_XXX.zip解壓到某個位置。以管理員身份運(yùn)行 CMD進(jìn)入解壓后的目錄執(zhí)行部署命令。# 進(jìn)入解壓后的部署包目錄 cd /d D:\DeploymentCenter\deploy_scripts\Env_Tc\install # 執(zhí)行部署腳本賬號密碼為 Deployment Center 的登錄賬號 deploy.bat -dcusernamedcadmin -dcpassworddcadmin -softwareLocationD:\DeploymentCenter\repository\software參數(shù)說明-dcusername和-dcpassword是 Deployment Center 的登錄賬號不是 Windows 賬號-softwareLocation是介質(zhì)所在倉庫根目錄必須指向D:\DeploymentCenter\repository\software這一層不要指到具體子目錄。部署過程會在 CMD 窗口里輸出進(jìn)度長時間沒有輸出不代表卡死去看部署包解壓目錄下的日志文件確認(rèn)當(dāng)前步驟。部署完成后按部署說明里記錄的訪問地址打開 AWC 登錄頁能看到登錄界面就算基本通了。從那以后我每次在組件頁點(diǎn)“轉(zhuǎn)至部署”前都會強(qiáng)制過一遍所有組件的狀態(tài)值確認(rèn)全部 100% 才生成腳本這個習(xí)慣幫我省掉了好幾次半夜回滾。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取