modeler

A GUI-based, licensed application for editing and viewing models, executing simulations, and analyzing simulation output results.

Description

The modeler program is the main working environment of the OPNET system. It comprises a suite of internal editors for manipulating models. These editors include the Project Editor, Node Editor, and Process Editor. Details about these and other editors are described in “Editors Reference”.

Preferences

This program supports the following preference sets:

This program also supports preferences for specific add-on functionality; these preferences are described in the corresponding manuals.

The following program-specific preferences are supported.

aliases_verify

Specifies whether to verify that all node aliases in the current scenario are unique. If TRUE, the verification is performed when you change a node alias, import a topology, or import an alias set. Duplicate aliases are listed in a text edit pad.

Type Default Value
boolean TRUE

allow_parallel_kernel

Specifies whether controls allowing the use of parallel kernels should be enabled in the detailed Configure/Run DES dialog box. When FALSE, the parallel kernel controls on the Execution > Advanced > Kernel Type page are disabled.

Type Default Value
boolean FALSE

an_mono_sym

Specifies whether the Analysis Tool panels drawn on monochrome displays should visually distinguish separate traces with unique marker symbols (such as triangles, circles, etc.). The value of this preference also applies to multi-trace panels that are printed, because print output is monochrome.

Type Default Value
boolean TRUE

apply_all_aliases

Specifies the persistence of aliases assigned to network objects for unmapped traffic in the Flows Browser after traffic import. By default, node aliases are persistent OPNET-wide. Setting this preference to FALSE makes node aliases persistent project-wide.

Type Default Value
boolean TRUE

auto_fire

Specifies whether the Analysis Tool panels automatically display statistics. If FALSE, panels are created empty and you must select the Show Statistic checkbox in the Edit Graph dialog box to draw each statistic.

Type Default Value
boolean TRUE

bgutil_errlog_incident_limit

Specifies the incident limit for the link load import error logs.

Type Default Value
integer 10

bgutil_gbu_bucket_size

Specifies the bucket size to be used for ASCII (.gbu, .gbu2) imports. This preference can be set also from the Import Baseline Loads from ASCII FIles dialog box.

Type Default Value
string “As Is”

bgutil_gbu_bucket_type

Specifies the bucket mode to be used for ASCII (.gbu, .gbu2) imports. This preference can be set also from the Import Baseline Loads from ASCII FIles dialog box.

Type Default Value
string “Average”

bgutil_gbu_file_list

Specifies a list of files to be imported as ASCII (.gbu, .gbu2) files. This preference can be set also from the Import Baseline Loads from ASCII FIles dialog box.

Type Default Value
string list <empty>

bgutil_gbu_from_time

Specifies the start of the time window for filtering ASCII (.gbu, .gbu2) data. This preference can be set also from the Import Baseline Loads from ASCII FIles dialog box.

Type Default Value
string “ALL VALUES”

bgutil_gbu_overwrite

Specifies whether ASCII (.gbu, .gbu2) imports should overwrite existing data. When TRUE, existing data is overwritten. This preference can be set also from the Import Baseline Loads from ASCII FIles dialog box.

Type Default Value
boolean TRUE

bgutil_gbu_to_time

Specifies the end of the time window for filtering ASCII (.gbu, .gbu2) data. This preference can be set also from the Import Baseline Loads from ASCII FIles dialog box.

Type Default Value
string “ALL VALUES”

bgutil_ignore_alias_case

Specifies whether to ignore the case of alias names when importing background utilization (link loads). When TRUE, case is ignored.

Type Default Value
boolean TRUE

comp_target_type.development_parallel_32

Specifies whether to generate this type of object file when compiling. Together with the other comp_target_type attributes, this allows you to produce multiple targets from a single source.

The value of this preference changes only at start-up.

Data Type Default Value
boolean FALSE

comp_target_type.development_parallel_64

Specifies whether to generate this type of object file when compiling. Together with the other comp_target_type attributes, this allows you to produce multiple targets from a single source.

The value of this preference changes only at start-up.

Data Type Default Value
boolean FALSE

comp_target_type.development_sequential_32

Specifies whether to generate this type of object file when compiling. Together with the other comp_target_type attributes, this allows you to produce multiple targets from a single source.

The value of this preference changes only at start-up.

Data Type Default Value
boolean TRUE

comp_target_type.development_sequential_64

Specifies whether to generate this type of object file when compiling. Together with the other comp_target_type preferences, this allows you to produce multiple targets from a single source.

The value of this preference changes only at start-up.

Data Type Default Value
boolean TRUE

comp_target_type.optimized_parallel_32

Specifies whether to generate this type of object file when compiling. Together with the other comp_target_type attributes, this allows you to produce multiple targets from a single source.

The value of this preference changes only at start-up.

Data Type Default Value
boolean FALSE

comp_target_type.optimized_parallel_64

Specifies whether to generate this type of object file when compiling. Together with the other comp_target_type attributes, this allows you to produce multiple targets from a single source.

The value of this preference changes only at start-up.

Data Type Default Value
boolean FALSE

comp_target_type.optimized_sequential_32

Specifies whether to generate this type of object file when compiling. Together with the other comp_target_type attributes, this allows you to produce multiple targets from a single source.

The value of this preference changes only at start-up.

Data Type Default Value
boolean FALSE

comp_target_type.optimized_sequential_64

Specifies whether to generate this type of object file when compiling. Together with the other comp_target_type preferences, this allows you to produce multiple targets from a single source.

The value of this preference changes only at start-up.

Data Type Default Value
boolean FALSE

disk_cleanup.clean_automatically

Specifies whether to automatically maintain the files it creates on disk. If TRUE, “old” files are automatically removed from disk as specified by the other disk_cleanup preferences. This preference can be changed also with the File > Delete Temporary Files… operation.

Data Type Default Value
boolean TRUE

disk_cleanup.clean_duplicate_scenarios

Specifies whether to automatically maintain the number of automation-generated scenarios in a project. If TRUE, duplicate scenarios older than specified by disk_cleanup.clean_duplicate_scenarios_days are automatically removed from disk when disk cleanup is executed. This preference can be changed also with the File > Delete Temporary Files… operation.

Data Type Default Value
boolean TRUE

disk_cleanup.clean_duplicate_scenarios_days

Specifies the number of days that automation-generated scenarios will be kept before being automatically removed from disk. This preference is used only when disk_cleanup.clean_duplicate_scenarios is TRUE. Its value can be changed also with the File > Delete Temporary Files… operation.

Data Type Default Value
integer 30

disk_cleanup.clean_error_log

Specifies whether to automatically maintain the size of the error log. When TRUE, error log entries older than specified by disk_cleanup.clean_error_log_days are automatically removed from disk when disk cleanup is executed. This preference can be changed also with the File > Delete Temporary Files… operation.

Data Type Default Value
boolean TRUE

disk_cleanup.clean_error_log_days

Specifies the number of days that error log entries will be kept before being automatically removed from the log. This preference is used only when disk_cleanup.clean_error_log is TRUE. Its value can be changed also with the File > Delete Temporary Files… operation.

Data Type Default Value
integer 30

disk_cleanup.clean_session_log

Specifies whether to automatically maintain the size of the session log. When TRUE, session log entries older than specified by disk_cleanup.clean_session_log_days are automatically removed from disk when disk cleanup is executed. This preference can be changed also with the File > Delete Temporary Files… operation.

Data Type Default Value
boolean TRUE

disk_cleanup.clean_session_log_days

Specifies the number of days that session log entries will be kept before being automatically removed from the log. This preference is used only when disk_cleanup.clean_session_log is TRUE. Its value can be changed also with the File > Delete Temporary Files… operation.

Data Type Default Value
integer 30

disk_cleanup.clean_temporary_files

Specifies whether to automatically maintain the temporary files in <HOME>\op_admin\tmp. When TRUE, temporary files older than specified by disk_cleanup.clean_temporary_files_days are automatically removed from disk. This preference can be changed also with the File > Delete Temporary Files… operation.

Data Type Default Value
boolean TRUE

disk_cleanup.clean_temporary_files_days

Specifies the number of days that temporary files will be kept before being automatically removed from disk. This preference is used only when disk_cleanup.clean_temporary_files is TRUE. Its value can be changed also with the File > Delete Temporary Files… operation.

Data Type Default Value
integer 7

edit_attr_undo_warning_prompt

If TRUE, specifies whether to display a warning dialog for non-undoable attribute-edit operations.

Type Default Value
boolean TRUE

ets_options

Specifies a list of unlicensed ETS-based product options.

The value of this preference changes only at start-up.

Type Default Value
string list <empty>

event_speed_parameter

Provides an advanced event management system that can be tuned to maintain peak performance when simulating very large systems. Larger values will result in faster simulations. The trade-off is that higher values for this preference require additional memory.

Optimal values depend on the type and size of models. You may wish to experiment with different values and compare the simulation's performance. In general, increasing this parameter will not yield significant performance gains for small, lightly-loaded systems.

Type Default Value
integer 100,000

file_abort_read_suppress

Prevents a program abort when a corrupted node model is read.

Type Default Value
boolean FALSE

flow_import_errlog_incident_limit

Specifies the maximum number of log messages recorded during flow imports for a particular category, class, and subclass.

Type Default Value
integer 100

hpov_default_server

Specifies the default HP OpenView network topology server to be used for imports.

Type Default Value
string “”

import_default_interface_type

Specifies the default interface type assigned during a topology import if a port or link’s interface type is not specified or cannot be identified. The interface type’s protocol and (optionally) speed can be specified by this preference (for example, ethernet:10BaseT is a valid default interface type).

Type Default Value
string “”

import_default_machine_type

Specifies the default machine type assigned during a topology import if an object’s machine type is not specified or cannot be identified (for example, “switch” is a valid default machine type).

Type Default Value
string “”

import_mem_stats_log

Specifies whether to log memory usage statistics during topology import operations. When FALSE, memory statistics are not logged.

Type Default Value
boolean FALSE

ip_address_change_notify_limit

Specifies the maximum number of change messages displayed when auto-assigning or clearing IP addresses.

Type Default Value
integer 0

javascript_enable

Specifies whether to use Javascript in the creation of results web reports. If TRUE, Javascript is used to create the results tables in the web report, allowing them to be manipulated in various ways. Ifn FALSE, the results tables are written out in plain HTML.

Note: Regardless of the value of this preference, the treeview in a web report is always created using Javascript.

Type Default Value
boolean TRUE

kernel_procedure_help

Specifies the type of online help for Kernel Procedures in the Process Editor. “built-in” specifies that Modeler opens the KP documentation included with the program. “web-based” specifies that Modeler launches the default browser and accesses the URL indicated by kernel_procedure_help_URL.

Type Default Value Constraints
enum built-in built-in, web-based

kernel_procedure_help_URL

Specifies the URL of online help for Kernel Procedures. This preference must be set if kernel_procedure_help is set to “web-based”.

Type Default Value
string “”

ma_errlog_incident_limit

Specifies the maximum number of incidents to be reported in a model assistant error log.

Type Default Value
integer 10

manage_licenses

Specifies whether to start with the License Manager running. If TRUE, there is only limited functionality, however, no license is used. (The License Manager is started automatically.) This mode is useful when performing license management functions only. You must use this mode if you are deleting all licenses, because the License Manager will not allow you to delete a license that is in use.

This preference can be entered only from the command line, and its value changes only at start-up.

Type Default Value
boolean FALSE

model_assistant_adjust_view_after_apply

Specifies whether autozoom is applied to the workspace following application of a model assistant file. If TRUE, the display is automatically zoomed to the affected objects.

The value of this preference changes only at start-up.

Type Default Value
boolean FALSE

model_assistant_configuration_file

Specifies a configuration file for the model assistant.

The value of this preference changes only at start-up.

Type Default Value
string “”

Specifies which link model attributes should be included in the link details section of the network summary report. If this preference and net_report_link_tooltip_alias are set to the default values, the link details section lists the name and link type of each link, organized by subnet. When modifying this preference, enter model attribute names exactly as shown in the Attributes dialog box.

Type Default Value
string “tooltip”

Specifies which link model attributes should be included in the link summary section of the network summary report. If this preference and net_report_link_tooltip_alias are set to the default values, the link summary section lists the total number of links and the number (count) by link type. When modifying this preference, enter model attribute names exactly as shown in the Attributes dialog box.

Type Default Value
string list “tooltip”

Definition of the tooltip attribute used in link sections of the network summary report. This is different from the UI tooltip (the explanatory text in a yellow box that appears when you place the cursor over buttons).

Type Default Value
string “Link Type”

net_report_node_details_attrs

Specifies which node model attributes should be included in the node details section of the network summary report. If this preference and net_report_node_tooltip_alias are set to the default values, the node details section lists the name and device type of each node, organized by subnet. When modifying this preference, enter model attribute names exactly as shown in the Attributes dialog box.

Type Default Value
string list “tooltip”

net_report_node_summary_attrs

Specifies which node model attributes should be included in the node details section of the network summary report. If this preference and net_report_node_tooltip_alias are set to the default values, the node details section lists the name and device type of each node, organized by subnet. When modifying this preference, enter model attribute names exactly as shown in the Attributes dialog box.

Type Default Value
string list “tooltip”

net_report_node_tooltip_alias

Definition of the tooltip attribute used in node sections of the network summary report. This is different from the UI tooltip (the explanatory text in a yellow box that appears when you place the cursor over buttons).

Type Default Value
string list “Device Type”

network_diff.default_live_spec

Specifies the default specification file for Live Object/Attribute Difference behavior.

Type Default Value
string “op_live_diff”

network_diff.default_report_spec

Specifies the default specification file for Object/Attribute Difference reports.

Type Default Value
string “op_network_diff”

network_diff.live_icon_use

Specifies where to use the icons for Live Object/Attribute Differences.

Type Default Value Constraints
enum workspace_and_treeview workspace_and_treeview, workspace_only, treeview_only

network_diff.output_dir

Specifies the directory to which Object/Attribute Difference report files are written.

Type Default Value
string “”

network_diff.suppress_live_legend

Specifies whether to suppress the legend that appears in the lower left-hand corner of the workspace while Live Object/Attribute Differences is active. This legend describes the active tracking mode and the meaning of each of the icons used to mark the various network objects. When FALSE, the legend is shown. When TRUE, the legend is suppressed.

Type Default Value
boolean FALSE

network_palette

Specifies a custom model list or set of keywords to be used initially with the object palette in the Project Editor. If this list is empty, no keywords or model list are set when starting programs and the object palette displays icons for all models in your model directories. Specifying this preference can save time when you open the object palette, because the palette displays fewer models.

The value of this preference must be one of the following:

  • One or more valid keywords. (Separate keywords by spaces on the command line, or commas elsewhere.)
  • The reserved word custom_model_list followed by a space and the name of an existing custom model list.

You can specify keywords or a custom model list with this preference, but not both at once.

Type Default Value
string list “”

network_palette.fixed_subnet_icon

Specifies the icon used for fixed subnet objects in the object palette. You can specify an icon from any database listed in the “icon_dbs” line in your modeler.ets file. If this preference is an empty string, the fixed subnet object will not appear in the object palette.

Type Default Value
string list “subnet“

network_palette.group_aggregation

Specifies the self-description core characteristic used to group objects in the object palette when model aggregation is enabled.

Type Default Value
string “System Object ID”

network_palette.keep_above

Specifies whether to prevent the object palette from being hidden behind the editor window. If TRUE, the object palette is kept in front of the editor window (but not other windows).

Type Default Value
boolean TRUE

network_palette.mobile_subnet_icon

Specifies the icon used for mobile subnet objects in the object palette. You can specify an icon from any database listed in the “icon_dbs” line in your modeler.ets file. If this preference is an empty string, the mobile subnet object will not appear in the object palette.

Type Default Value
string “subnet (mobile)”

network_palette.only_one

Specifies whether to limit a network model to only one open object palette at a time. If FALSE, any number of object palettes can be open for a network model. If TRUE, an attempt to open a second object palette will bring the existing object palette window to the front and activate it.

Type Default Value
boolean FALSE

network_palette.satellite_subnet_icon

Specifies the icon used for satellite subnet objects in the object palette. You can specify an icon from any database listed in the “icon_dbs” line in your modeler.ets file. If this preference is an empty string, the satellite subnet object will not appear in the object palette.

Type Default Value
string “subnet (mobile)”

nmx_no_dynamic

Specifies whether to allow use of DNS for HP NetMetrix traffic import. Setting this preference to TRUE forces NetMetrix to ignore DNS for resolution of addresses found in the archives being read.

Otherwise, if NetMetrix was installed to use DNS, importing archives can be very lengthy, as every Internet address found in the archive will be checked to find the corresponding host name. If the address is bogus or the corresponding site cannot be found, the search ends after a lengthy time-out, giving the impression that the import is going nowhere.

Type Default Value
boolean TRUE

no_snap

Specifies that graphical objects being placed within editors not have their locations snapped to an invisible grid. Applies to Node and Process Editors only.

Type Default Value
boolean FALSE

nt_model_post_conversion_library

Specifies a library containing a post-conversion pre-processor function used to perform any additional cleanup work after automatic model conversion.

Type Default Value
string “”

nt_model_post_conversion_proc

Specifies a post-conversion pre-processor function used to perform any additional cleanup work after automatic model conversion.

Type Default Value
string “”

nt_model_pre_conversion_library

Specifies a library containing a pre-conversion pre-processor function used to perform any setup work for automatic model conversion.

Type Default Value
string “”

nt_model_pre_conversion_proc

Specifies a pre-conversion pre-processor function used to perform any setup work for automatic model conversion.

Type Default Value
string “”

num_collect_values

Specifies the default maximum number of values to collect for each statistic during a simulation. This value can be changed for a given scenario in the Configure/Run DES dialog box.

Type Default Value
integer 100

panels_plot_area_pack

Specifies whether analysis panels should be drawn with a margin (empty space) around the graph area. When TRUE, a graph will completely fill the analysis panel.

Data Type Default Value
boolean TRUE

panels_vector_x_axis_mode

Specifies what scale to use for the x axis in analysis panels and the Results Browser preview pane. “default” labels the x axis using the network date and time, if available. “Auto-scale” labels the x axis in seconds, minutes, hours, or days, whichever is most appropriate to the length of the simulation. “Seconds” forces the use of seconds.

Data Type Default Value Constraints
enum Auto-scale default, Auto-scale, Seconds

panels_y_axis_bottom_margin

Specifies how much empty space to draw between the minimum vertical scale and the bottom frame of the graph. This space prevents the bottom frame from obscuring any low data values in the graph.

Data Type Default Value
integer 5

panels_y_axis_top_margin

Specifies how much empty space to draw between the maximum vertical scale and the top frame of the graph. This space prevents the top frame from obscuring any high data values in the graph.

Data Type Default Value
integer 3

parallel_sim.num_processors

Specifies the number of processors to be used by the Simulation Kernel. This preference applies only to the parallel kernels. If this preference is set to 0 or Maximum, the simulation will try to determine the number of CPUs available and use them all. This value can be changed for a given scenario with the “Number of threads” field on the Kernel Type page of the Configure/Run DES dialog box.

WARNING: Requesting that simulations use more CPUs than are physically present and available will degrade simulation performance dramatically.

Type Default Value
integer 1

parallel_sim.unknown_process_mt_safety_handling

Specifies how the parallel simulation kernel treats processes of unknown MT-safety. When this preference is set to “assumed_unsafe”, they are executed sequentially. With “assumed_safe”, they are treated as MT-safe and run in parallel when possible. Refer to “Parallel Simulation Concepts” on page 400 for more details.

Type Default Value Constraints
enum assumed_unsafe assumed_unsafe, assumed_safe

product

Specifies the product mode in which the modeler program should run, which determines the feature set of the program. The possible product modes include:

  • Riverbed Modeler (“modeler”)
  • Riverbed SteelHead NetPlanner (“netplanner”)
  • Riverbed SteelHead NetAuditor (“netauditor”)

The value of this preference changes only at start-up.

Type Default Value
enum modeler

product_options

Specifies a list of modules that add additional functionality.

Type Default Value
string list <empty>

repositories

Specifies the set of code repositories to load for a simulation. If you specify repository files, op_runsim uses them instead of the default set.

Type Default Value Constraints
string list <empty> <empty>, “none”, “stdmod”, valid repository files

show_import_help

Specifies whether to display an import help dialog when failing to connect to a server. If TRUE, the help dialog is displayed.

Type Default Value
boolean TRUE

show_map_edit_mode_help_msg

Specifies whether to display a help message when entering map edit mode in the Project Editor. If TRUE, the help message is displayed.

Type Default Value
boolean TRUE

spreadsheet_prog

Specifies the path to the spreadsheet program that launches when data is exported. The value can be simply the program name if the program is in a directory specified by the path variable.

If no value is specified, the export operation still takes place, but the spreadsheet program does not launch. The data is exported to a text file stored in the op_admin/tmp directory.

Type Default Value
string “”

static_bk_util.archive_dir

Specifies the list of directories in which background load data files are stored. The specified directories are used when importing data from a NetworkHealth (.dci) data file, an MRTG configuration (.cfg) file, or a General Background Utilization (.gbu) file.

Type Default Value
string “”

top_n_results_min_significant_digits

Specifies the minimum number of significant digits in a Find Top Results report.

Type Default Value
integer 0

traffic_archive_dir

Specifies the path to a directory in which archive files can be found.

Type Default Value
string “”

traffic_default_interval

Specifies the interval (in seconds) used to subdivide imported traffic when intervals are not otherwise known.

Type Default Value
double 30

traffic_import_suppress_unrecognized_sources_dialog

Specifies whether to suppress the unrecognized sources dialog box after a traffic flow import. If FALSE, the dialog box is displayed; If TRUE, it is suppressed.

Type Default Value
boolean FALSE

traffic_preprocessor_prog

Specifies a list of external preprocessing scripts used to convert ASCII traffic files to Flexible CSV (.tr2) format. These scripts appear in the Import Traffic dialog box’s Traffic Preprocessor menu.

Note: You must include the full path name for any scripts located outside your user path.

Type Default Value
string list <empty>

traffic_profile_undef_value_treat_as_zero

Specifies how undefined values in traffic profiles should be handled during simulation. When TRUE, undefined values are treated as 0.0; when FALSE, the previous numeric value in the profile is used.

Type Default Value
boolean TRUE

undo_stack_size

Specifies the maximum number of undoable operations.

Type Default Value
integer 10

use_metric

Specifies whether the Startup Wizard should use metric units as a default.

Type Default Value
boolean TRUE

use_network_editor_warning

Specifies whether to display migration information when starting the Network Editor.

Type Default Value
boolean TRUE

use_scenario_prompt

Specifies whether to prompt for a scenario name when creating a new project.

Type Default Value
boolean TRUE

use_startup_wizard

Specifies that the Startup Wizard will launch automatically each time a new scenario is created.

You can also control the Startup Wizard via the “Use Startup Wizard for each new scenario” checkbox in the initial Startup Wizard dialog box. This method supersedes this preference—unchecking the checkbox will prevent the Startup Wizard from launching even if this preference is set to TRUE.

Type Default Value
boolean TRUE

value_notch_filter_tolerance

Specifies the range used by the value_notch filter to generate an output statistic. Given an input statistic T0 and an ordinate value x, the value_notch filter eliminates T0 if it is greater than x – value_notch_filter_tolerance and less than x + value_notch_filter_tolerance. Otherwise the value_notch filter simply sends T0 to the filter output. See also “Value Notch Filter” on page 474.

Type Default Value
double 1-E9

word_processing_prog

Specifies the path name of the word processing program that launches when a text report is generated. The value can be simply the program name if the program is in a directory specified by the path variable.

If no value is specified, the report is still generated, but the word processing program does not launch. The report is stored in the op_admin/tmp directory.

The value of this preference changes only at start-up.

Type Default Value
string “”

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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