从先前版本迁移自定义内容——12.0 之前
由于协议要求的特殊性,你可能在 Riverbed Modeler 的先前版本中自定义过模型或代码。Riverbed Modeler 的后续版本和更新可能包含对代码和模型的更改,这些更改可能取代你的自定义内容。由于某个版本的进程模型或节点模型未必能在另一个版本中正常工作,理解发生了哪些变化至关重要,这样你才能成功地把自定义内容迁移到新版本。本工作流给出了一套有用的方法,描述了从先前版本迁移自定义内容的过程。
注意: 本工作流仅适用于 Riverbed Modeler 用户。
如果你要跨多个版本迁移,也就是从 10.5 版本迁移到 14.0 版本,就必须执行多次迁移。本工作流将指导你完成从更早版本直至 12.0 版本的模型迁移。另见从先前版本迁移自定义内容,其中给出了如何把模型迁移到 18.6 版本的说明。
图 1给出了本文所述的工作流。
图 1:自定义内容迁移工作流

软件组件:从先前版本迁移自定义内容——14.0 之前
本工作流只需要标准的 Riverbed Modeler 软件,不需要额外的模块。不过,如果你使用专用模型,可能需要为这些特定模型取得额外许可。
前提条件:从先前版本迁移自定义内容——14.0 之前
本工作流假定你对 Riverbed Modeler 以及对其底层代码的定制有一定经验。要高效地完成本工作流,你应当已经了解自己软件中的自定义内容。
工作流步骤:从先前版本迁移自定义内容——14.0 之前
下面是针对你所拥有的自定义类型必须执行的各项过程的指南。在步骤 1 所描述的大多数情形中,你可以跳过步骤 2 和步骤 3。但如果你修改过 Riverbed 创建的模型,就必须继续执行所有步骤。
步骤 1:规划迁移
注意: 在开始本工作流之前,务必阅读最新 Riverbed Modeler 版本的发行说明(Release Notes)。
要在 Riverbed Modeler 的两个版本之间平滑迁移,最好先有一份扎实的计划。这包括整理你所做更改和自定义内容的文档,然后确定你希望在新版本中使用哪些项目、场景、流量、模型或代码。
拓扑与流量数据
如果你通过导入拓扑和(或)流量数据创建了一个项目,那么只需把这些信息重新导入更新后的 Riverbed Modeler 版本中的新项目即可。
模型助手文件
如果你有一个包含对象位置信息的模型助手(Model Assistant)文件,那么可以直接在更新后的 Riverbed Modeler 版本中使用它。
使用会创建对象、销毁对象或更改对象属性的模型助手文件时要格外小心。在 Riverbed 模型库的最新版本中,属性名称、结构和功能可能已经发生变化。因此,依赖旧属性结构的模型助手文件可能无法被正确应用。你还可能发现,已经不再需要模型助手文件就能达到同样的建模目标。
注意: 阅读发行说明,了解先前版本的模型助手文件所需的特殊行为或转换要求。
自动设备与属性转换
警告: 如果你修改过底层代码、属性或模型,仅靠自动转换不足以把更改迁移到新版本。
自动设备转换是一种方式,通过它 Riverbed Modeler 可以把你在 Device Creator 中、基于上一个模型库版本创建的模型转换为可在新版本中工作。要使用自动转换,请在新版本中打开你的项目,并按照出现的对话框中的提示操作。
注意: 自动转换的设计目标是用于 Riverbed Modeler 相邻版本之间,如果你跳过了某些版本,它可能无法正常工作(例如,从带 2004 年 1 月 29 日模型的 10.5 PL0 版本转换到带 2005 年 12 月 20 日模型的 11.5 PL1 版本)。
属性转换会自动为你完成。例如,如果某个属性的位置自上一个版本以来已经移动,Riverbed Modeler 会自动把你现有模型中的值映射并转移到新版本中的正确位置。
自定义模型
如果你的自定义模型与 Riverbed 模型库没有任何交互——也就是说,你没有修改过 Riverbed 创建的模型的底层代码或节点模型——那么转换很简单:在新版本中打开你的项目。
如果你有针对 Riverbed 创建模型的底层代码做过自定义的模型,请继续本工作流的下一个步骤。
步骤 2:确定差异
虽然阅读 Riverbed Modeler 最新版本的发行说明是一个好的起点,但发行说明并不会逐行描述属性和模型的更改。要更好地理解发生了哪些变化、以及你需要如何修改自己的自定义内容,你必须针对每个修改过的文件找出各文件版本之间的差异。
图 2示意了你必须在其间确定差异的各个模型。一个 Riverbed 模型同时存在较旧和较新的版本。如果你在先前版本中修改过某个 Riverbed 模型,就必须把这些更改迁移到新的 Riverbed 模型中。因此,你必须先找出先前版本中的 Riverbed 模型与你的自定义模型之间的差异,然后再找出先前 Riverbed Modeler 版本中的模型与新版本中的模型之间的差异。
图 2:确定差异

依据你在先前版本中修改过的文件清单,酌情执行下述各项过程。
如果你修改过数据包格式或 ICI 格式,使用过程 1。
过程 1:查找数据包格式(pk.m)或 ICI 格式(ic.m)的差异
- 为原始的 Riverbed 模型生成一个文件。
- 1.1 打开先前 Riverbed Modeler 版本中的原始模型。
- 1.2 选择 File > Generate Text Report。
- 1.3 保存该报告。
- 为包含你修改内容的模型生成一个文件。
- 2.1 打开先前 Riverbed Modeler 版本中的模型。
- 2.2 选择 File > Generate Text Report。
- 2.3 保存该报告。
- 为新版本中的 Riverbed 模型生成一个文件。
- 3.1 打开模型文件。
- 3.2 选择 File > Generate Text Report。
- 3.3 保存该报告。
- 使用 UNIX 的
diff命令、Microsoft 的 Windiff 或其他文件比较工具,找出你在步骤 1中生成的文件与在步骤 2中生成的文件之间的差异。你可以把这个差异记作 Δ1。 - 找出你在步骤 1中生成的文件与在步骤 3中生成的文件之间的差异。你可以把这个差异记作 Δ2。
- 对每种此类文件中你做过自定义的每一个文件都执行上述操作。
如果你修改过进程模型或节点模型,使用过程 2。
注意: 该过程不适用于带有专用许可的进程模型。对这类模型而言,唯一的比较方法是生成
pr.c文件并加以比较。
过程 2:查找进程模型(pr.m)或节点模型(nd.m)的差异
- 为原始的 Riverbed 模型生成一个文件。
- 1.1 打开先前 Riverbed Modeler 版本中的原始模型。
- 1.2 选择 File > Generate XML Code。
- 1.3 保存该 XML 文件。
- 为修改过的模型生成一个文件。
- 2.1 打开先前 Riverbed Modeler 版本中的模型。
- 2.2 选择 File > Generate XML Code。
- 2.3 保存该 XML 文件。
- 为新版本中的 Riverbed 模型生成一个文件。
- 3.1 打开模型文件。
- 3.2 选择 File > Generate XML Code。
- 3.3 保存该 XML 文件。
- 使用 UNIX 的
diff命令、Microsoft 的 Windiff 或其他文件比较工具,找出你在步骤 1中生成的文件与在步骤 2中生成的文件之间的差异。你可以把这个差异记作 Δ1。 - 找出你在步骤 1中生成的文件与在步骤 3中生成的文件之间的差异。你可以把这个差异记作 Δ2。
- 对每种此类文件中你做过自定义的每一个文件都执行上述操作。
如果你有自定义的 ex.c 或 .h 文件,这些文件本身已经适合比较。因此,你不必生成文本报告或 XML 代码文件。要找出文件之间的差异,使用过程 3
过程 3:查找 ex.c 或 .h 文件的差异
- 使用 UNIX 的
diff命令、Microsoft 的 Windiff 或其他文件比较工具,找出先前 Riverbed Modeler 版本中的原始模型与你在先前 Riverbed Modeler 版本中的自定义模型之间的差异。你可以把这个差异记作 Δ1。 - 找出先前 Riverbed Modeler 版本中的原始模型与新版本中的模型之间的差异。你可以把这个差异记作 Δ2。
- 对每种此类文件中你做过自定义的每一个文件都执行上述操作。
如果你有自定义的链路模型或自定义的需求模型,就必须手工比较模型以找出差异。使用过程 4确定这些差异。
过程 4:查找链路或需求模型的差异
- 找出第一个差异。
- 1.1 打开先前 Riverbed Modeler 版本中的原始链路或需求模型,以及你在先前 Riverbed Modeler 版本中的自定义链路或需求模型。
- 1.2 比较这两个模型并记录差异。你可以把这些差异记作 Δ1。
- 找出第二个差异。
- 2.1 打开先前 Modeler 版本中的原始链路或需求模型,以及新版本中的链路或需求模型。
- 2.2 比较这两个模型并记录差异。你可以把这些差异记作 Δ2。
- 对每种此类文件中你做过自定义的每一个文件都执行上述操作。
步骤 3:迁移自定义内容
在确定了旧模型与新版本中模型之间的差异之后,你就可以开始迁移过程。
过程 5:迁移自定义内容
- 为了节省工作量,在做出更改之前使用下述决策路径。
-
如果 Δ1 小于 Δ2,就把 Δ1 引入新版本 Riverbed Modeler 中的文件,如下图所示。
图 3:Δ1 < Δ2 的情形

注意: 尽管本过程旨在为决策以及代码与模型自定义内容的合并提供指南,但务必仔细考虑各项修改,检查修改内容并把它们合并到你的新模型中。
-
如果 Δ1 大于 Δ2,就把 Δ2 引入自定义模型,如下图所示。
图 4:Δ1 > Δ2 的情形

-
- 对每个自定义模型,按照步骤 1中确定的方案做出更改。
- 保存你的新自定义模型。
- 在新版本中尝试运行离散事件仿真之前,重新编译所有修改过的模型代码。
步骤 4:验证更改
迁移完自定义内容后,通过比较在 Riverbed Modeler 旧版本上和新版本上运行离散事件仿真所得的结果,来验证你所做的更改。确保结果相似且不产生严重错误。必要时对你的更改进行故障排查,以调试代码修改。