CATIA V5 PowerBy 安装及常见问题

一、准备工作

1.1、服务器Apps部署

服务器端需要安装Apps，并根据需要安装SP补丁：

• ENOVIAIntegrationExchangeFramework
• ENOVIAUnifiedX-CADDesignManagement

1.2、用户授权

PowerBy的用户需要分配Role和相应的协作区

Role：UE5 – Collaborative Designer for CATIA V5

1.3、检查CATIA & JDK版本要求

在PDir Multibrand文件中查询各个服务器版本支持的CATIA

一般来说，3DE平台支持对应的CATIA V5版本及历史版本

同时，同一个页面下面也有要求的JDK版本

二、安装步骤

2.1、安装JDK并导入证书

1、下载JDK：

a、官方默认只支持Oracle JDK 和 IBM JDK：

Oracle JDK：

Java Downloads | Oraclehttps://www.oracle.com/java/technologies/downloads/

IBM JDK：

IBM DeveloperIBM Developer is your one-stop location for getting hands-on training and learning in-demand skills on relevant technologies such as generative AI, data science, AI, and open source.https://developer.ibm.com/languages/java/semeru-runtimes/downloads/

b、国内镜像：

WEJDK学习站injdk JDK怎么安装 JDK怎么下载 Java Java开发 OracleJDK OpenJdk下载 JDK 下载JDK 下载openjdk https://www.injdk.cn/

3、安装JDK（zip/exe/msi）

4、设置环境变量：

JAVA_HOME=C:\Java\jdk-17.0.10

5、导入证书

用管理员权限运行命令行程序，执行命令

keytool.exe -import -keystore lib\security\cacerts -alias MyDomainCA -file MyRootCA.crt -storepass changeit -noprompt

也可以使用如下批处理：

set JAVA_HOME=D:\DassaultSystemes\Java\jdk-17.0.3+7

%JAVA_HOME%\bin\keytool.exe -import -keystore %JAVA_HOME%\lib\security\cacerts -alias MyDomainCA -file %~dp0..\MyRootCA.crt -storepass changeit -noprompt

pause

注意：必须指定证书库（cacerts）路径，应为JDK下的存储库；如不指定，可能会在当前运行路径生成存储库，而不导入JDK的证书库

2.2、安装CATIA V5及补丁

安装CATIA V5，并配置License，不在赘述。

CATIA V5可以根据需要安装Service Package（SP）及HotFix（HF）补丁，但不是必须的。

2.3、安装IEF客户端

安装ENOVIAIntegrationExchangeFrameworkClient.Windows64

安装过程中将自动验证JDK环境，如验证不通过，将弹出如下提示，明确了要求的JDK版本，需要重新配置JDK环境及环境变量JAVA_HOME并重新执行安装程序

设置本地3DEXPERIENCE服务器URL地址

该地址信息及相关设置将保存在配置文件中，后续也可以手动修改：

\DassaultSystemes\B426xcadconnectors\win_b64\reffiles\IEFClientWorkspaceService\config.xml

2.4、安装XCADDesignConnectors

该步骤同样会检查JDK配置，如果配置不符合要求，依然会弹出错误提示。

2.5、CATIA V5 PowerBy配置

集成模式选择PowerBy

文档环境 > 3DEXPERIENCE > 允许

已链接的文档本地化 > PowerBy 3DEXPERIENCE > 是 > [提升到第2位]

已链接的文档本地化 > 指向文档的文件夹 > 是 > [提升到第3位]

CGR管理 > 将线元素保存在CGR中 > 是

2.6、启动CATIA V5 PowerBy

启动CATIA V5，点击菜单：3DEXPERIENCE > 连接…

正常情况下，将弹出登录界面，用3DEXPERIENC已分配的用户进行登录

同时，系统将自动启动IEF客户端，在后台运行，显示在任务栏图标：

登录成功后，将在CATIA右下角提示连接成功信息

此时PowerBy菜单已进入可用状态，可以开始使用PowerBy进行协同设计

­三、常见问题

3.1、无法启动IEF客户端

问题分析：IEF客户端核心为jar包（IEFClientWorkspaceService.jar），IEF客户端无法正常启动，通常都是JDK问题。

解决方案：

1、检查相应平台版本要求的JDK版本，目前只支持Oracle JDK和IBM JDK

2、检查CATIA V5及IEF客户端环境文件中JDK设置

\DassaultSystemes\CATEnv\CATIA.V5-6R2024.B34.txt

\DassaultSystemes\B423xcadconnectors\CATEnv\Env.txt

3、检查JDK中是否正确导入了服务器根证书

3.2、登录后自动取消登录

问题分析：此时客户端已经能正常连接到3DEXPERIENCE服务器，软件运行环境基本正常，考虑是以登录的用户权限或者许可证问题。

解决方案：

1、检查用户是Role是否已分配，License调用是否正常

2、检查用户的协作区权限，是否有可用的协作区

3.3、客户端版本不匹配

问题分析：ENOVIAIntegrationExchangeFrameworkClient通常没有Windows版本补丁，主要是XCADDesignConnectors版本不匹配。

解决方案：

1、安装相应版本的XCADDesignConnectors补丁