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