在开发环境中重新创建 IBM Business Automation Workflow 目标对象库

在线编辑

Draft comment:
This topic is shared by BAW, CP4BA. Last updated on 2025-01-20 10:38

如果 IBM Business Automation Workflow 的开发目标对象库已损坏或不可用，那么可以重新创建该对象库。

故障现象

开发活动期间，目标对象库可能已损坏或被置于不确定状态。

解决问题

要恢复目标对象库，必须重新创建其元数据和标准环境。因此，运行时数据（例如案例和文档）丢失。要重新创建该对象库，您必须为系统管理员，且熟悉以下概念：

IBM Administration Console for Content Platform Engine
Business Automation Workflow 的常规安装步骤
Content Platform Engine， Business Automation Workflow以及集成系统上配置的组件 (例如 Case History ， Case Analyzer) 的常规安装和管理技能

要重新创建 Business Automation Workflow 目标对象库，请执行以下过程:

备份设计对象库数据库。
使用 IBM FileNet® Deployment Manager 来导出要保留的外部解决方案工件。有关更多信息，请参阅在重置测试环境之前保存用户定义的资产。
记下目标对象库和引用此库的内容管理系统的其他组件的属性。您需要这些属性值来清除资源并重新创建组件。例如，以下属性很重要：
- 服务器、数据库实例和数据库模式的名称。
- 数据库连接和数据源的名称。
- 目标对象库的表、索引和大对象 (LOB) 以及工作流程系统数据的存储位置。
- 对于目标对象库，请注意:
  - 符号名称
  - 您向其授予管理和基本访问权的用户组
  - 项目区域名称
  - IBM Content Navigator 桌面名称
  - 案例操作用户名和密码
- 添加到目标对象库的任何附加组件。要确定附加组件，请登录 IBM Administration Console for Content Platform Engine，选择目标对象库，单击操作，然后单击安装附加功能部件。记下已安装附加组件功能部件列表中有哪些附加组件，然后单击取消。
- 对于工作流程系统，记下缺省语言环境、日期/时间掩码、XSL/XSD 基本目录、工作流程系统管理和配置组、流程编排代理 servlet URL、公共侦听器 URL、连接点名称和隔离区域名称。
- 对于案例分析器库，记下事件修剪安排和发布时间间隔。
- 对于目标对象库，请注意:
  - 符号名称
  - 您向其授予管理和基本访问权的用户组
  - 项目区域名称
  - IBM Content Navigator 桌面名称
  - 案例操作用户名和密码
将应用程序服务器超时值设置为至少 600 秒。
1. 传统内部部署:
  以下样本设置适用于 WebSphere® Application ServerV 8.5.2:
  - 服务器 > 服务器类型 > WebSphere Application Server > "配置" 选项卡 > 容器设置 > 容器服务 > 事务服务 > 总事务生存期超时
  - 服务器 > 服务器类型 > WebSphere Application Server > "配置" 选项卡 > 容器设置 > 容器服务 > 事务服务 > 最大事务生存期超时
  - 服务器 > 服务器类型 > WebSphere Application Server > "配置" 选项卡 > 容器设置 > 容器服务 > ORB 服务 > 请求超时
  - 服务器 > 服务器类型 > WebSphere Application Server > "配置" 选项卡 > 容器设置 > 容器服务 > ORB 服务 > 查找请求超时
    注: 对于 WebSphere Application Server V 8.5.2，查找请求超时的最大值为 300。
  - 资源 > JDBC > 数据源 > [Content Engine 或 Case Manager 数据源名称] > 连接池属性 > 连接超时
    Draft comment: fmosher
    Has the navigation changed?
  - 资源 > JDBC > 数据源 > [Content Engine 或 Case Manager XA 数据源名称] > 连接池属性 > 连接超时
    Draft comment: fmosher
    Has the navigation changed?
2. Containers:
  调整此Liberty集装箱设置：
- ```
<server>
<transaction
clientInactivityTimeout=1800s 
propogatedOrBMTTranLifetimeTimeout=1800s 
totalTranLifetimeTimeout=1800s
/>
</server>
```
  请参阅调整 IBM WebSphere Liberty 以适应 FileNet Content Manager 组件。
仅停止一个 Content Platform Engine 节点或副本
- 传统内部部署-如果 Content Platform Engine 正在应用程序服务器集群中运行，请停止除其中一个节点外的所有节点。
- 容器-如果 Content Platform Engine 的多个 pod 正在运行，请将副本数减少为 1。
在 IBM Administration Console for Content Platform Engine中，首先删除引用目标对象库的所有组件 (包括连接点和工作流程系统) ，然后删除目标对象库。更多信息，请参阅：删除对象存储。
注意以下信息：
- "删除对象库" 主题未提供可引用对象库的所有集成组件 (例如， Case Analyzer 库) 的完整列表。如果存在引用目标对象库的组件，那么必须删除这些组件，才可删除目标对象库。
- 删除案例历史记录库时，可能会收到与以下错误类似的错误：
```
由于发生以下错误，导致无法删除案例历史记录库： 
com.filenet.api.exception.EngineRuntimeException: FNCRE0066E: 
E_UNEXPECTED_EXCEPTION: An unexpected exception occurred. The unexpected 
exception is chained to this exception. Message was: null FNRAM9022
```
  发生此错误时，请登录到 IBM Administration Console for Content Platform Engine ，然后选择 [ECM 域名] > 全局配置 > 管理 > 数据库连接 > [目标对象存储数据库连接]。在属性选项卡上，滚动到“事件导出库”属性。验证此值是否未引用事件导出库。属性值必须是 Event Export Stores或 <No items found>。
在 IBM Administration Console for Content Platform Engine中，执行以下任务:
- 导航到与目标对象库关联的设计对象库中的连接定义：对象库 > [设计对象库名称] > 浏览根文件夹 > IBM Case Manager > 数据集 > DevEnvReinitInfo > [连接定义名称]。
  Draft comment: fmosher
  Has the navigation changed?
- 删除 DeployDataset 之外的所有文档。请勿更改 DeployDataset 文档。删除存在的以下文档：CodeModules、DevEnvReinitManifest 和 DevEnvReinitStatus。
注销 IBM Administration Console for Content Platform Engine，然后停止 IBM Administration Console for Content Platform Engine 以及可能正在访问目标对象库的任何定制应用程序。
停止 Content Platform Engine
- 传统本地-停止最后一个 Content Platform Engine 节点。
- 容器-对于 Content Platform Engine pod ，将副本数减少到零。
对于使用数据库的每个已删除组件，登录到数据库管理控制台，删除其模式中所有用户表，仅保留系统表。这些组件包含工作流程系统和目标对象库。如果任何其他删除的组件具有数据库表，请同时删除这些表。例如，案例分析器库是具有数据库表的组件。
注: 删除目标对象库表之后，还必须删除与目标对象库数据库模式关联的序列。更多信息，请参阅删除对象存储。
重新启动 Content Platform Engine
- 传统本地-启动 Content Platform Engine。在集群环境中，启动所有节点。
- 容器-对于 Content Platform Engine pod ，将您选择的副本数更改为一个或多个。
要添加对象，请登录到 IBM Administration Console for Content Platform Engine，选择 "对象存储库" 节点，然后单击新建存储库。
- 使用与原始目标对象库相同的符号名称。
- 复用原始目标对象库的 targetd 模式的数据库连接。
- 对其授予管理访问权的用户组必须具有“完全控制”访问权。新目标对象访问与项目区域关联的连接定义。对其授予基本访问权的用户组必须对连接定义具有“查看属性”访问权。
- 在 " 选择附加组件 " 窗口中，单击缺省应用程序配置。请勿选择其他任何附加组件。
在 IBM Administration Console for Content Platform Engine中，浏览至连接定义的安全性选项卡:
1. 对象库 > [目标对象库名称] > 浏览 > 根文件夹 > IBM Case Manager > 数据集 > DevEnvReinitInfo > [连接定义名称] > 安全
  Draft comment: fmosher
  Has the navigation changed?
2. 验证目标对象库管理和常规（基本访问权）用户组是否具有安全性访问权（先前步骤中进行了描述）。对其授予管理访问权的用户组必须具有“完全控制”访问权。此对象仅访问与项目区域关联的连接定义。对其授予基本访问权的用户组必须对连接定义具有“查看属性”访问权。
在 IBM Administration Console for Content Platform Engine 中，导航至 “对象存储 ”> “[目标对象存储名称]” > “管理 ”> “工作流系统 ”。单击新建以添加工作流程系统。
注: 您可以在原始工作流程系统中复用相同的属性，例如数据库存储位置 (表，索引， LOB) ，连接点名称和区域名称。
使用下列其中一种方法重新配置目标对象库:
- 案例配置工具-传统内部部署
  - 对于开发环境，请参阅准备运行案例配置任务。
  - 对于生产环境，请参阅准备运行配置任务。
  - 运行以下任务:
    1. 配置案例管理对象库。此步骤可添加目标对象库和分析附加组件。
    2. 注册项目区域。
    3. 配置 Business Rules。
- 案例管理客户端
  1. 转换为目标对象库。
  2. 注册项目区域。
- 容器环境:
  1. 重新运行 {{case-init }}job
    注: 这仅适用于缺省项目区域。对于其他项目区域，请使用 Case 管理客户机。
在 IBM Administration Console for Content Platform Engine中，从原始目标对象库添加仍需要添加的任何附加组件。
部署工作流程项目或案例解决方案。
使用 FileNet Deployment Manager 来导入要保留的外部解决方案工件。
重新创建任何已删除的其他集成组件。