Licensing Preferences
Licensing preferences are supported by any licensed application, such as Modeler and op_runsim. Preferences enable you to configure various aspects of program operation. In Riverbed analysis software, you can view and modify preferences by choosing Edit > Preferences. You can also use these preferences as arguments when managing licenses from the command line (see "Managing Licenses from the Command Line" on page 49).
Enable HTTPS for Express License Registration
Enables secure communication with the Riverbed license registration server. The default value is TRUE. In rare cases, you may wish to disable HTTPS (for example, when you are using a web proxy), though this is not recommended.
| Tag | Data Type | Default Value |
|---|---|---|
license_https_enable |
Boolean | TRUE |
Note: If you set this preference to FALSE, you must also set the License HTTP Server preference to "licensing.opnet.com," or licensing will fail with an error message. Communications will then be conducted over an unencrypted channel and may expose sensitive information during the transaction.
Username for License Authentication
Specifies the username that will be sent to the web server during express license transactions. Used with License Password to authenticate yourself to the web server.
| Tag | Data Type | Default Value |
|---|---|---|
license_username |
string | "" |
License Password
Specifies the password used for authentication before beginning an express license registration through technical support on the Riverbed Support web site. This is typically the same password you use when entering the Riverbed support web site. This preference value is stored in encrypted format.
| Tag | Data Type | Default Value |
|---|---|---|
license_password |
password | "" |
License HTTP Server
Specifies the web server the License Manager uses when performing license transactions via the Riverbed web site.
| Tag | Data Type | Default Value |
|---|---|---|
license_http_server |
string | "license01.opnet.com" |
License Group ID
Specifies your group ID number, the number assigned to you by Riverbed when you purchased the software. To find your group ID, choose About This Application from the Help menu. Your group ID is used for express license registrations on the technical support web site.
| Tag | Data Type | Default Value |
|---|---|---|
license_group |
string | "" |
Use HTTP Proxy
Specifies whether to use an HTTP proxy server for express license registrations.
| Tag | Data Type | Default Value |
|---|---|---|
license_http_use_proxy |
Boolean | FALSE |
HTTP Proxy Server Port
Specifies an HTTP proxy server port to be used for express license registrations.
| Tag | Data Type | Default Value |
|---|---|---|
license_http_proxy_port |
integer | 80 |
HTTP Proxy Server Name
Specifies an HTTP proxy server to be used for express license registrations.
| Tag | Data Type | Default Value |
|---|---|---|
license_http_proxy_server |
string | "" |
HTTP Proxy Server Username
Specifies a user name to use when authenticating to an HTTP proxy server. If your site controls access to the Internet with an HTTP proxy server, you should set this preference to allow express licensing transactions to take place.
| Tag | Data Type | Default Value |
|---|---|---|
license_http_proxy_user |
string | "" |
Password for HTTP Proxy Server Authentication
Specifies a password to use when authenticating to an HTTP proxy server. If your site controls access to the Internet with an HTTP proxy server, you should set this preference to allow express licensing transactions to take place. This preference is stored in encrypted format.
| Tag | Data Type | Default Value |
|---|---|---|
license_http_proxy_password |
password | "" |
Managed Servers
Specifies a space-separated list of <server>, <port> pairs to be explicitly contacted by the License Manager. This preference causes license servers that are not in the same IP network segment as the License Manager to appear in the license server treeview. If <port> is not specified, "port_a" is assumed. For example: iasimov,port_a rbradbury,port_b aclarke10.
| Tag | Data Type | Default Value |
|---|---|---|
license_managed_servers |
string list | <empty> |
License Server Port
Specifies the name of the communication port. This preference can have one of three possible values: port_a, port_b, or port_c. This preference is used in conjunction with License Server Name to uniquely identify a server running the licensing process and must be assigned a value.
To determine which ports are available for use by op_license_server, run op_license_util in port check mode on the machine where a license server is to be run (op_license_util -port_check). The licensing system uses UDP ports for communication. Each port corresponds to a UDP port (port_a is 2047, port_b is 2123, and port_c is 2345).
On Linux platforms, you can change this preference by stopping op_license_server, then re-starting it with the new License Server Port value.
| Tag | Data Type | Default Value |
|---|---|---|
license_port |
string | "port_a" |
License Server Name
Specifies the name of a server that has a license file and can allocate licenses to clients requesting them. The server name is a string that follows the naming conventions supported by the TCP/IP protocol suite. This means that simple names (such as cbanana) and dot-separated addressing domains (athena.foo.edu) are supported. This preference is used with License Server Port to uniquely identify a server running the licensing process. An error will occur if a licensing process is not running on the specified host computer or if the host computer is not found. This preference must be assigned a value.
| Tag | Data Type | Default Value |
|---|---|---|
license_server |
string | "localhost" |
Standalone License Server
Specifies that modeler will run in standalone licensing mode. In this mode, the program acts as its own license server. Other machines cannot get licenses from this server. Only this single instance of the application will launch.
This preference can be used with modeler or op_runsim, but not with op_license_server. When this preference is TRUE, the License Server Name and License Server Port preferences are ignored.
| Tag | Data Type | Default Value |
|---|---|---|
license_server_standalone |
Boolean | FALSE |
Diagnose Standalone License Server
Specifies that modeler will run in standalone licensing mode and will send diagnostic information to the license log. In this mode, the program acts as its own license server. Other machines cannot get licenses from this server. Only this single instance of the application will launch.
This preference can be used with modeler or op_runsim, but not with op_license_server.
| Tag | Data Type | Default Value |
|---|---|---|
license_server_standalone_diagnose |
Boolean | FALSE |
Enable Simplified Loanable License
Specifies whether the license manager supports simplified loanable licensing.
| Tag | Data Type | Default Value |
|---|---|---|
license_simple_loanable_enable |
Boolean | TRUE |
Maintenance Warning Interval
Specifies the interval in days between maintenance expiration warnings. These warnings are automatically displayed when you exit a program that requires a license, beginning 60 days before expiration and ending when maintenance is renewed. The warning appears every n days, where n is the value of this preference, except for the period beginning 7 days before expiration and ending 7 days after expiration, when the warning appears every day.
| Tag | Data Type | Default Value |
|---|---|---|
mtn_warn_int |
integer | 3 |
Ping Old Servers
Specifies whether the License Manager should try to locate servers from prior releases of Riverbed analysis software. If TRUE, the License Manager will take longer to start up as it looks for old license servers on the network.
| Tag | Data Type | Default Value |
|---|---|---|
license_ping_old_servers |
Boolean | FALSE |