3. 安装与配置基础

Active Workspace（AWC）的安装不是“双击下一步”就能完成的桌面软件安装，它本质上是把一层 Web 前端与中间件部署到既有的 Teamcenter 环境之上，并让它能够正确访问数据库、卷（Volume）和文件服务。因此，安装质量取决于三件事：介质与版本是否匹配、数据库与 FSC 是否就绪、部署后能否通过验证。本节按这条主线展开，重点讲清每一步的输入、关键操作和判断依据。

一、安装介质准备：先对齐版本，再谈安装

AWC 的安装介质通常来自 Siemens 官方下载中心（Support Center），核心是 AWC_<版本>.zip 或对应的 awc_<版本>_<平台>.tar.gz，其中包含 awc.war、install 目录、模板配置文件和 awc.properties 样例。准备阶段要确认四类信息：

• Teamcenter 版本：AWC 与 TC 有严格的兼容矩阵，例如 AWC 6.3 通常对应 TC 13.3/14.2，AWC 5.2 对应 TC 13.2。版本错配会导致登录后页面空白或 REST 接口 404。
• 应用服务器：AWC 以 WAR 包形式部署，需要 WebLogic、WebSphere 或 Tomcat 之一，并确认 JDK 版本（如 JDK 11 或 17）。
• 数据库与 FSC：Oracle 或 SQL Server 的实例、端口、服务名，以及 FSC（File Server Cache）的卷和端口。
• 许可与主机名：确认 license 文件已就位，且服务器主机名、FSC 主机名可被客户端解析。

建议在安装前把介质解压到独立目录，例如 /opt/siemens/awc_6.3，并核对 install/awc.properties.template 中的占位符，避免安装脚本因路径含空格或中文而失败。

二、数据库与 FSC 配置：AWC 的数据与文件底座

AWC 本身不直接管理业务数据，它通过 Teamcenter 的 SOA/REST 接口访问数据库，通过 FSC 访问文件卷。因此数据库与 FSC 必须在 AWC 安装前完成配置。

数据库侧：确认 TC 数据库实例已创建，且 tcuser 具备连接权限。典型连接串形如 jdbc:oracle:thin:@dbhost:1521:TCORCL。若使用 Oracle，需检查 tnsnames.ora 与监听状态；若使用 SQL Server，需确认 TCP/IP 协议已启用、端口 1433 可达。数据库连接信息最终会写入 TC 的 tc_profilevars 或 DB_CONNECT 配置，AWC 通过 TC 间接使用，不需要在 AWC 中重复配置数据库账号。

FSC 侧：FSC 是 Teamcenter 的文件服务缓存，负责卷（Volume）的读写。配置要点包括：

• 在 FSC 配置文件中定义 FSC_HOME、FSC_PORT（默认 1999）和 FSC_VOLUMES。
• 卷路径需具备读写权限，例如 /tcdata/volumes/volume1，并确保磁盘剩余空间充足。
• 启动 FSC 后，用 fscstat 或管理控制台确认状态为 Running，且卷已挂载。

一个常见的教学示例参数如下（仅作示例，实际以环境为准）：数据库主机 tc-db01，端口 1521，服务名 TCORCL；FSC 主机 tc-fsc01，端口 1999，卷路径 /tcdata/volumes/volume1。这些值会在后续 AWC 配置中作为连接目标出现。

三、AWC 安装步骤：从 WAR 到可访问的 Web 应用

AWC 安装可分为“准备配置—部署 WAR—配置连接—启动服务”四步。以 Tomcat 为例：

1. 准备配置：复制 awc.properties.template 为 awc.properties，填写 tc.server.url（如 http://tc-app01:7001/tc）、fsc.host、fsc.port、awc.context（如 /awc）。
2. 部署 WAR：将 awc.war 放入 Tomcat 的 webapps 目录，或通过管理控制台部署。Tomcat 会自动解压为 awc 目录。
3. 配置连接：在 awc.properties 中确认 TC 的 SOA 端点、FSC 地址和认证方式（如 SSO 或 TC 登录）。若使用 HTTPS，还需配置证书信任库。
4. 启动服务：启动 Tomcat，观察 catalina.out 日志，确认无 ClassNotFoundException 或 Connection refused。

安装过程中最值得观察的是日志中的连接建立信息：当看到 Connected to Teamcenter 和 FSC connection established 时，说明 AWC 已成功对接后端。若出现 401 Unauthorized，通常是认证配置或 TC 用户权限问题；若出现 404，则要检查 tc.server.url 是否指向正确的 TC Web 应用。

四、验证安装结果：用真实操作确认闭环

安装完成后，不能只看 Tomcat 是否启动，而要用真实业务动作验证。建议按以下顺序检查：

1. 访问入口：浏览器打开 http://tc-app01:8080/awc，应出现 AWC 登录页。若页面空白，查看浏览器控制台是否有 JS 加载失败。
2. 登录：使用 TC 用户（如 infodba 或普通用户）登录，确认能进入主界面。
3. 数据访问：搜索并打开一个已有部件，确认属性、BOM 或结构能正常显示，说明 TC 数据通道正常。
4. 文件访问：对部件执行“上传文件”或“下载文件”，确认文件能写入 FSC 卷并在客户端下载成功。这一步同时验证了 FSC 的读写权限和网络连通性。
5. 日志复核：在 catalina.out 中确认出现 Connected to Teamcenter 与 FSC connection established，且无持续报错。

把上述四步串起来看，AWC 安装的实质是：介质准备保证“装得对”，数据库与 FSC 配置保证“连得上”，WAR 部署与属性配置保证“跑得起来”，验证保证“用得成”。每一步都有明确的输入和可观察的输出，只要按这个顺序排查，绝大多数安装问题都能定位到具体环节，而不是停留在“装不上”的模糊状态。