面向 Riverbed Modeler 用户的信息
本文档的其余部分面向模型开发者(例如 Riverbed Modeler 用户)。以下各节讨论理解 Server 模型的内部细节以及与其接口所必需的主题。
模型架构
下图展示了 Server 模型所在的典型节点模型。Server 模型所使用的进程模型位于 CPU 处理器中。
图 527:进程模型位于 CPU 处理器中

表 202:进程模型
| 进程模型 | 说明 |
|---|---|
server_definer |
包含全网范围的信息,例如硬件配置信息,以及与具体服务器无关的作业定义。 |
server_mgr |
这是 server 模块的根进程。对于 Simple CPU 建模方式,它提供与 oms_resource 包的接口。 |
server_dispatch |
由 server_mgr 派生,负责在服务器内启动和停止作业。 |
server_cpu |
由 server_mgr 派生,负责管理服务器的 CPU 资源,例如调度和按处理器评级进行缩放 |
server_disk |
由 server_mgr 派生,实现存储分区和物理磁盘仿真,包括磁盘接口和磁盘驱动器。 |
gna_remote_storage_mgr |
由 gna_clsvr_mgr 在所有将 “Server: Modeling Method” 设置为 “Detailed Server” 的节点上派生 |
gna_remote_storage_client |
由 gna_remote_storage_mgr 在收到 server disk 进程模型发起的、要访问远程服务器存储分区的请求时派生 |
gna_remote_storage_server |
由 gna_remote_storage_mgr 派生,用于接受远程客户端访问存储分区的请求 |
模型接口
以下各节讨论与 Server 模型接口所必需的主题。
数据包格式
Server 模型不使用数据包。所有网络传输都通过自定义应用模型(custom application models)完成。
ICI 格式
下表列出 Server 模型套件中使用的接口控制信息(ICI)格式。
表 203:ICI 格式
| ICI | 说明 |
|---|---|
server_dispatch_ici |
该 ICI 在 server_dispatch 进程模型中用于在各状态之间传递作业信息。 |
server_job_ici |
该 ICI 由 server 各进程用于传递正在执行的作业的相关信息。它由 OMS_Server 包通过进程中断在进程之间传递。 |
server_remote_storage |
该 ICI 在 server_disk 进程模型中用于与 gna_remote_storage_client 进程模型通信。 |
oms_job_data |
该 ICI 由 server_dispatch 进程模型创建,用于把作业完成信息传递给提交该作业的进程。 |
指示(Indications)
服务器与应用之间的接口基于对 OMS_Server 包的函数调用,以及服务器返回给应用的指示。命令和指示由 C 头文件 oms_server.h(位于 <models>/std/include 目录)中定义的符号常量标识;任何与 Server 模型交互的应用都应查看该文件以获得这些定义。
Server 模型目前只使用一种指示。
表 204:指示说明
| 指示 | 说明 |
|---|---|
OMSC_JOB_COMPLETE |
表示一个作业(或部分作业)已经完成。 |
应用层接口
强烈建议应用只通过 Server API 访问服务器的功能。下表列出该包提供的主要函数。
表 205:API 包说明
ServerT_Job_Table_Handle Server_Get_Job_Table_Handle (Objid node_id)
- Purpose(用途):获取作业表的句柄——创建作业时必须先获得它
- Arguments(参数):包含应用进程的服务器对象 ID
- Return Value(返回值):包含后续所有 API 调用所需作业信息的句柄
ServerT_Job_Handle Server_Create_Job (ServerT_Job_Table_Handle job_table_handle, const char *job_name)
- Purpose(用途):创建一个新的作业实例
- Arguments(参数):
- 调用 Server_Get_Job_Table_Handle() 返回的句柄
- 在服务器作业表中定义的作业名称。
- Return Value(返回值):与该作业实例关联的句柄
ServerT_Job_Handle Server_Create_Dynamic_Job (ServerT_Job_Table_Handle job_table_handle, const char *job_name, const char *baseline_server, const char *job_class, const char *cpu_time, int priority, const char *page_fault, const char *n_reads, const char *n_writes, const char *read_block_size, const char *write_block_size, List *read_storage_partition_distribution, List *write_storage_partition_distribution)
- Purpose(用途):用于作业细节是动态的情形。当作业完成时,它即不复存在。
- Arguments(参数):
- 调用 Server_Get_Job_Table_Handle() 返回的句柄
- 作业名称。如果该作业名已存在于作业表中,则会使用其中的信息,例如读/写磁盘分布。如果不存在,该名称只用于统计量报告
- 进行实测时所用服务器的类型名称。若设置为 OPC_NIL,则假定实测与包含该应用的服务器属于同一类型
- 用于作业缩放的作业类别,如 Server Configuration 对象中所定义。只有当 baseline_server 设置为 OPC_NIL 时,该值才可以为 OPC_NIL
- 描述该作业 CPU 需求的分布字符串
- 作业的处理优先级,取值从 0(最低)到 9(最高)
- 描述该作业页面错误数量的分布字符串
- 定义该作业执行的磁盘读操作次数的分布字符串
- 定义该作业执行的磁盘写操作次数的分布字符串
- 定义该作业执行的磁盘读操作大小的分布字符串
- 定义该作业执行的磁盘写操作大小的分布字符串
- 包含存储分区名称及其读访问权重的列表
- 包含存储分区名称及其写访问权重的列表
- Return Value(返回值):与该作业实例关联的句柄
Boolean Server_Job_Handle_Valid (ServerT_Job_Handle job_instance)
- Purpose(用途):检查该作业实例句柄是否有效。
- Arguments(参数):与某个作业实例关联的句柄
- Return Value(返回值):作业句柄有效时返回 TRUE,否则返回 FALSE I
void Server_Process_Job (ServerT_Job_Handle job_instance, Prohandle calling_proc, void* job_data)
- Purpose(用途):执行作业直至完成
- Arguments(参数):
- 与某个作业实例关联的句柄
- 在作业完成时接收进程中断的进程。该中断代码的值为 OMSC_JOB_COMPLETE
- 要传递给被中断进程的信息
- Return Value(返回值):无
void Server_Process_Partial_Job (ServerT_Job_Handle job_instance, Prohandle calling_proc, void* job_data, double execution_units, double total_execution_units)
- Purpose(用途):执行作业的一部分
- Arguments(参数):
- 与某个作业实例关联的句柄
- 在作业片段完成时接收进程中断的进程。该中断代码的值为 OMSC_JOB_COMPLETE
- 要传递给被中断进程的信息
- 要完成的作业比例的分子
- 要完成的作业比例的分母
- Return Value(返回值):无
void Server_Close_Job (ServerT_Job_Handle job_handle)
- Purpose(用途):结束一个作业实例。写出尚未写出的统计量,并释放与该作业关联的资源。
- Arguments(参数):与某个作业实例关联的句柄
- Return Value(返回值):无
void Server_Abort_Job (ServerT_Job_Handle job_handle)
- Purpose(用途):中止一个作业实例并清理与之关联的资源。
- Arguments(参数):与某个作业实例关联的句柄
- Return Value(返回值):无
使用该包需要在进程头块(header block)中包含 “server_api.h”,并把 “server_support” 声明为外部文件。