OPNET Development Kit 运行时环境

文件组织

你的应用程序可能会使用自定义图标、启动画面、ETS 文件和菜单文件。你可以:

  • 将这些文件保存在用户的 op_models 目录中。如果你只有少量自定义文件,可选择此方式。

  • 将这些文件集成到目录结构中。例如,你的自定义图标可以放在 <install_dir>/<release>/sys/icons 目录中。如果你选择这种组织方式,请参阅“File System Organization“(第 2 页)和“System Directory (sys)“(第 4 页)中关于文件系统的说明。

    如果你的应用程序与 NetPlanner 类似,这会是一个不错的选择,因为它利用了现成的文件结构。

  • 创建你自己的结构,独立于 NetPlanner 结构。示例结构如下:

    图 1:示例文件组织

    示例文件组织

    如果你选择此方式并且需要包含 netbiz.ets 文件,请将其放在 configs 目录中。

运行时执行

偏好设置

偏好设置(也称为环境属性)在第 2 章“Preferences”(第 30 页)中有详细说明。本节介绍与应用开发者最相关的几个要点。

OPNET Development Kit 应用提供了多种指定偏好设置的机制。你可以:

  • 在命令行上指定偏好设置,如下所示:

    netbiz -prefs_file my_prefs_file
    
  • 使用 shell 变量。

  • 使用默认偏好设置文件(<home>/op_admin/opnet-<rel>.prefs)中的值,或修改该文件。

  • 在环境(.ef)文件中指定偏好设置及其值。环境文件位于 <reldir>\sys\configs\global_prefs。

  • 使用注册表(仅限 Windows)。

由于有五种不同的偏好设置传递机制,同一偏好设置可能通过多种机制被赋值。各偏好设置传递机制的优先顺序如下图所示。该优先顺序是固定且不可修改的。被更高优先级机制覆盖的偏好设置赋值不会生效。

图 2:偏好设置优先级

偏好设置优先级

在偏好设置名称前加上可执行文件的名称(例如 your_application),可以使同一偏好设置拥有不同的设置值。加上名称实际上创建了两个不同的偏好设置。

例如,假设你有一个偏好设置文件,同时用于 your_application(使用启动画面 your_splash_screen)和 NetPlanner(使用启动画面 modeler_splash_screen)。你的偏好设置文件可以同时包含偏好设置 modeler.splash_image(值为 modeler_splash_screen)和 your_application.splash_image(值为 your_splash_screen)。启动任一应用程序时,都会显示正确的启动画面。

如果某个偏好设置既以当前可执行文件的名称定义(例如 your_application.splash_image),又不带任何可执行文件名称定义(splash_image),则前者的值具有优先级,无论这些值定义在哪里。

例如,假设 your_application.splash_image 在偏好设置文件中定义为 cool_splash_screen,而 splash_image 在环境文件中定义为 boring_splash_screen。your_application.splash_image 的值具有优先级并会被显示,尽管环境文件中的偏好设置通常优先于偏好设置文件中的偏好设置。

常被定制的偏好设置

以下列表介绍应用开发者经常定制的一些偏好设置。

  • prefs_file – 指定要使用的偏好设置文件的名称。可以是文件的完整路径;如果文件位于默认位置(<HOME>/op_admin/),也可以只是文件名。如果使用此偏好设置,必须将其放在命令行上,并且必须最先指定。

    你可以在开发应用程序时使用一个偏好设置文件,但为部署环境准备另一个不同的文件。你可能还会为 NetPlanner 或其他分析软件准备第三个偏好设置文件。

  • ets_options – 指定包含 env_db_enhance() 函数的 ETS 库(op_*.<environment>.<arch_suffix>.ets.<type>)。例如,如果你的库名为 op_my_app.gui32.i0.ets.so,则 ets_options 应设置为 my_app。

    如果偏好设置文件不存在,你的 OPNET Development Kit 应用的核心部分会创建一个。该偏好设置文件可能满足也可能不满足你的应用程序的需要。因此,你可能希望提供一个 env_db_enhance() 函数来适当地修改偏好设置文件。ets_options 偏好设置告诉 OPNET Development Kit 应用去哪里寻找你的函数。有关 env_db_enhance() 函数的详细信息,参见创建自定义偏好设置文件。

  • icon_dbs – 指定要使用的图标数据库文件(*.icons)的名称。这些也可以在主编辑器配置文件中指定。

    你可能已经为你的应用程序创建了自定义图标数据库;它们将在该偏好设置中指定。

  • opnet_user_home – 指定 op_admin 和 op_models 目录的位置。默认情况下,NetPlanner 在 <HOME> 目录中查找这些目录。此偏好设置必须从命令行指定。

通用偏好设置

你可能还需要定制下列偏好设置之一。你可以使用前面描述的任意机制来定制这些偏好设置的值。

  • console – 打开或关闭控制台窗口(你可以在其中打印调试信息)。
  • console_exit_pause – 在程序退出时、控制台窗口被销毁之前暂停。
  • expanded_subnets_iconic – 指定子网展开时是以图标还是以带边框的矩形显示。
  • expanded_subnets_thickness – 指定展开的子网的带边框矩形的粗细。
  • mod_dirs – 列出你的应用程序查找模型文件的目录。
  • network_add_world_map_to_new_models – 为新网络模型(场景)的顶层子网添加世界地图。
  • network_links_infer_threshold – 指定链路应根据其端点的阈值确定自身粗细,还是使用其 thickness 属性的值。
  • network_palette – 指定要使用的调色板文件(*.cml)。对于名为 my_palette.cml 的文件,应将其设置为字符串列表 (custom_model_list, my_palette)。你应始终先输入字符串 custom_model_list,然后输入 .cml 文件的名称(本例中为 my_palette)。
  • network_palette.fixed_subnet_icon – 指定调色板上固定子网要使用的图标。要从调色板中移除固定子网,将其设置为空字符串 “”。
  • network_palette.mobile_subnet_icon – 指定调色板上移动子网要使用的图标。要从调色板中移除移动子网,将其设置为空字符串 “”。
  • network_palette.satellite_subnet_icon – 指定调色板上卫星子网要使用的图标 要从调色板中移除卫星子网,将其设置为空字符串 “”
  • network_show_links_to_parent_subnet_objects – 指定是否显示连接当前子网中的对象与不在当前子网中的对象的链路。
  • network_use_trx_prompt – 指定在绘制链路时是否提示用户输入发送和接收节点。
  • opnet_dir – 分析软件的根目录。当重新创建偏好设置文件时,Riverbed 会在该目录树中查找模型目录。
  • product – 指定获取何种类型的许可证,以及使用哪个主编辑器配置文件(modeler.ets, netbiz.ets)。
  • product_options – 指定使用哪些模块(如 ESP 和 ACE)。每个模块通常需要单独的许可证。
  • prof_track – 指定是否跟踪并打印性能分析统计量。性能分析统计量用于调试。要生成性能分析统计量,你的代码必须包含 FIN 和 FOUT 语句,并且必须在定义了 VOSD_PROFILE 的情况下编译。
  • prof_track_func – 收集详细性能分析统计量的函数名称。
  • program_resources – 要使用的资源文件(*.wrc)的名称。这些也可以在主编辑器配置文件中指定。
  • splash_image – 在系统窗口中使用的图像文件(*.image)的名称。
  • tooltip.link_attributes – 在链路工具提示中显示的链路属性名称。当用户将鼠标悬停在链路上时,会显示链路工具提示。
  • tooltip.site_attributes – 在站点工具提示中显示的站点(节点或子网)属性名称。当用户将鼠标悬停在站点上时,会显示站点工具提示。
  • use_startup_wizard – 指定是否为新建项目调用 Startup Wizard(启动向导)。必须将其设置为 TRUE 才能使用 ets_startup 函数。ets_startup 函数在主编辑器配置文件中指定。
  • use_tooltip_as_link_title – 指定在显示链路的标题时使用属性 “tooltip” 还是属性 “name”。有关显示链路标题的信息,参见函数 Ets_Obj_UI_Status_Set()(第 1060 页)。

创建自定义偏好设置文件

OPNET Development Kit 应用创建的默认偏好设置文件可能不适合你的应用程序。要在 OPNET Development Kit 应用启动之后“即时”替换偏好设置文件,你可以创建一个自定义的 env_db_enhance() 函数。该函数允许你向偏好设置文件中添加偏好设置或修改现有偏好设置。

如果存在 env_db_enhance() 函数,则在默认偏好设置文件构建完成之后,会发生以下事件序列:

  1. 应用程序创建默认偏好设置文件的副本。

  2. 应用程序调用 env_db_enhance() 函数。参数 file_name 是偏好设置文件副本的名称。

  3. env_db_enhance() 函数运行。该函数的典型实现执行以下操作:

    a) 创建临时文件(在图 3的示例中为 env_db_temp_name)。 b) 为增强后的偏好设置文件中应包含的每个偏好设置(包括要更改或添加的偏好设置)向临时文件写入语句。 c) 将临时文件复制到函数调用中给定的文件(file_name)。 d) 删除临时文件。

  4. 应用程序自动用 file_name 替换默认偏好设置文件。

你的函数会增强 OPNET Development Kit 应用当前正在使用的偏好设置文件,无论其名称是什么。编写函数时,请遵循以下准则:

  • 你的函数名称必须遵循 <lib name>_env_db_enhance 模式。例如,如果你将该函数编译到名为 my_lib.gui32.i0.ets.dll 的库中,则应将函数命名为 my_lib_env_db_enhance()。

  • 你的函数的原型如下:

    DLLEXPORT int <lib name>_env_db_enhance (char* file_name)
    
  • 包含此函数的库必须位于 ODK 应用的某个核心目录中(标准模型目录或核心软件目录均可)。推荐位置是 sys/configs。

  • 如果你使用 C++ 代码,你的函数必须按照所有必需约定声明为 extern C 函数。

  • 作为参数传递的文件(file_name)是偏好设置文件副本的完整路径和文件名。当函数完成时,该文件成为偏好设置文件。不要直接修改 file_name;而是在函数结束时用临时文件替换它。

  • 当此函数完成时,原始偏好设置文件会被自动替换为 file_name。这意味着你必须确保你的临时文件:

    • 设置所有变量(包括所有 mod_dirs)
    • 不移除原始偏好设置文件中 ODK 应用可能需要的任何内容

    注意,在你替换 file_name 之前,你可以用它访问原始偏好设置文件的内容。通过解析该文件,你可以获取默认的信息和设置。

  • 你的函数在成功时应返回 1(或任何正数),在不成功时应返回 0(或任何负数)。

图 3:env_db_enhance 函数示例

//compile this function into my_lib.gui32.i0.ets.dll

extern "C"
{
DLLEXPORT int
my_lib_env_db_enhance (char* file_name)
	{
	FILE*		env_db_temp_file_ptr;
	FILE*		env_db_file_ptr;
	char		env_db_temp_name [256];

	FIN (my_lib_env_db_enhance (file_name));

	/* Open temporary preferences file that we will be reading from */
	if  ((env_db_file_ptr = fopen (file_name, "r")) == NULL)
		{
		printf ("\nUnable to open file for reading: %s \n", file_name);
		FRET (0);
		}

	/* Open temporary preferences file that we will be writing to */
	sprintf (env_db_temp_name, "%s_temp", file_name);

	if  ((env_db_temp_file_ptr = fopen (env_db_temp_name, "w")) == NULL)
		{
		printf ("\nUnable to open file for writing: %s \n", env_db_temp_name);
		FRET (0);
		}

	fprintf (env_db_temp_file_ptr,"#My Application Environment File\r\n\r\n\r\n");
	fprintf (env_db_temp_file_ptr,"arch_prog\t\t  : arch_msvc\r\n");

	fprintf (env_db_temp_file_ptr,"tooltip.link_attributes\t\t  : \r\n");
	fprintf (env_db_temp_file_ptr,"\t\t\t    tooltip, name\r\n");

	fprintf (env_db_temp_file_ptr,"tooltip.site_attributes\t\t  : \r\n");
	fprintf (env_db_temp_file_ptr,"\t\t\t    tooltip, name\r\n");
	fprintf (env_db_temp_file_ptr,"network_palette\t\t  : custom_model_list,\r\n");
	fprintf (env_db_temp_file_ptr,"\t\t\t    internet_toolbox\r\n");

	fclose (env_db_file_ptr);
	fclose (env_db_temp_file_ptr);
	my_file_copy (env_db_temp_name, file_name);

	/* Delete the temp file. */
	_unlink (env_db_temp_name);

	FRET (1);
	}
}

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com