|
-C file | --panelConfig file
|
Specifies the panels-initialization file to use for displaying this dashboard. file is the full pathname of the .ini file.
|
|
-c logical-name:host:port:bool | --correlator logical-name:host:port:bool
|
Sets the correlator host and port for a specified logical correlator name. bool is one of true and false, and specifies whether to use the raw channel for communication. This overrides the host, port, and raw-channel setting specified by the Dashboard Builder for the given correlator logical name; see Changing correlator definitions for deployment. You can specify connection details for multiple correlators by using the option multiple times in a single command. Here is an example: -c default:localhost:15903:false –c work1:somehost:19999:true
These options set the host and port for the logical names default and work1.
|
|
-D | --nodirect
|
Suppress the check box in the login dialog that allows a direct connection to the correlator.
|
|
-d | --direct
|
Connect directly to the correlator.
|
|
-E bool | --purgeOnEdit bool
|
Specifies whether to purge all trend data when an instance is edited. bool is one of true and false. If this option is not specified, all trend data is purged when an instance is edited. In most cases, this is the desired mode of operation.
|
|
-F arg | --filterInstance arg
|
Exclude instances which are not owned by the user. This option applies to all dashboard processes. Default is false for builder and true for the other dashboard processes. Exception: when the Dashboard Viewer is connecting to a dashboard server, the default is true and cannot be overridden.
|
|
-f file | --logfile file
|
Full pathname of the file in which to record logging. If this option is not specified, the options in the log4j properties file are used. See also Text internationalization in the logs.
|
|
-G file | --trendConfigFile file
|
Trend configuration file for controlling trend-data caching.
|
|
-h | --help
|
Emit usage information and then exit.
|
|
-I | --xmlRedirect
|
Redirect XML sources through data server.
|
|
-J file | --jaasFile file
|
Full pathname of the JAAS initialization file to be used by the data server. If not specified, the data server uses the file JAAS.ini in the lib directory of your Apama installation.
|
|
-j | --singleClick
|
Single click for drill down and actions.
|
|
-k | --doubleClick
|
Double click for drill down and actions.
|
|
-L file | --xmlSource file
|
XML data source file. If file contains static data, append :0 to the file name. This signals Apama to read the file only once.
|
|
-m mode | --connectMode mode
|
Correlator-connect mode. mode is one of always and asNeeded. If always is specified, all correlators are connected to at startup. If asNeeded is specified, correlators are connected as needed. If this option is not specified, the data server connects to correlators as needed When --connectMode always is specified, trend data starts collecting upon correlator connection. When --connectMode asNeeded is in effect, trend data starts collecting after you select an attachment to the trend table in the Dashboard Viewer.
|
|
-N name | --name name
|
Set the component name for identification in the correlator. The default name is Dashboard Viewer: username.
|
|
-B logical-name:host:port | --namedServer logical-name:host:port
|
Sets the host and port for a specified logical data server name. This overrides the host and port specified by the Dashboard Builder for the given server logical name. This option can occur multiple times in a single command.
|
|
-n | --noSplash
|
Do not display splash screen in startup.
|
|
-e | --noMenus
|
Do not display menu bar.
|
|
-O file | --optionsFile file
|
Use the specified OPTIONS.ini file at startup.
|
|
-P n | --maxPrecision n
|
Maximum number of decimal places to use in numerical values displayed by dashboards. Specify values between 0 and 10, or -1 to disable truncation of decimal places. A typical value for n is 2 or 4, which eliminates long floating point values (for example, 2.2584435234). Truncation is disabled by default.
|
|
-q options | --sql options
|
Configures SQL Data Source access. options has the following form:
[retry:ms | fail:n | db:name |
noinfo | nopererr | quote]
retry: Specify the interval (in milliseconds) to retry connecting to a database after an attempt to connect fails. Default is -1, which disables this feature.
fail: Specify the number of consecutive failed SQL queries after which to close this database connection and attempt to reconnect. Default is -1, which disables this feature.
db: Specify the logical name of the database as specified in the builder’s SQL options.
noinfo: Query database for available tables and columns in your database. If a Database Repository file is found, it is used to populate drop down menus in the Attach to SQL Data dialog.
nopererr: SQL errors with the word “permission” in them will not be printed to the console. This is helpful if you have selected the Use Client Credentials option for a database. In this case, if your login does not allow access for some data in their display, you will not see any errors.
quote: Encloses all table and column names specified in the Attach to SQL Data dialog in quotes when an SQL query is run. This is useful when attaching to databases that support quoted case-sensitive table and column names. If a case-sensitive table or column name is used in the Filter field, or you are entering an advanced query in the SQL Query field, they must be entered in quotes, even if the -sqlquote option is specified.
|
|
-R bool | --purgeOnRemove bool
|
Specifies whether to purge all DataView data when an instance or item is removed. bool is one of true and false. If this option is not specified, all DataView data is purged when an instance or item is removed.
|
|
-S variable:value | --sub variable:value
|
Specifies a value to substitute for a given dashboard variable. This can be used to parameterize a dashboard at startup. This option can occur multiple times in a single command. For example: -S $foo:hello -S $bar:can't -S $tom:"my oh my" -S $jerry:"\"yikes\""
If the value contains a space, enclose the value in double quotes. If the value contains a double quote, you must escape it by using a backslash character (\).
|
|
-s host:port[:modifiable] | --dashboardServer host:port[:modifiable]
|
Specifies the data server host and port that will appear as the defaults in the Data Server Login dialog. The host and port fields of the dialog will be modifiable only if you specify modifiable. If you do not specify modifiable, the host and port fields will be greyed out. If you use the -s option, the Connect directly to correlator check box will not appear in the Data Server Login dialog. The -s option overrides the -d option.
|
|
-T depth | --maxTrend depth
|
Maximum depth for trend data, that is, the maximum number of events in trend tables. If this option is not specified, the maximum trend depth is 1000. Note that the higher you set this value, the more memory the data server requires, and the more time it requires in order to display trend and stock charts.
|
|
-t value | --title value
|
Text for the title bar of the Dashboard Viewer main window.
|
|
-u rate | --updateRate rate
|
Data update rate in milliseconds. This is the rate at which the data server pushes new data to deployed dashboards in order to inform them of new events received from the correlator. rate should be no lower than 250. If the Dashboard Viewer is utilizing too much CPU, you can lower the update rate by specifying a higher value. If this option is not specified, an update rate of 500 milliseconds is used.
|
|
-V | --version
|
Emit program name and version number and then exit.
|
|
-v | --loglevel level
|
Logging verbosity. level is one of FATAL, ERROR, WARN, INFO, DEBUG, and TRACE. If this option is not specified, the options in the log4j properties file will be used.
|
|
-w bool | --disconnectWarning bool
|
By default, the Dashboard Viewer will display a warning dialog when the connection to a correlator is lost. Specify false to disable the display of this dialog.
|
|
-X file | --extensionFile file
|
Full pathname of the JAAS initialization file to be used by the data server. If not specified, the data server uses the file EXTENSIONS.ini in the lib directory of your Apama installation.
|
|
-x table-name:key-list | --queryIndex table-name:key-list
|
Add an index for the specified SQL-based instance table with the specified compound key. table-name is the name of a DataView. key-list is a comma-separated list of variable names or field names. If the specified DataView exists in multiple correlators that are connected to the dashboard server, the index is added to each corresponding data table. Example:
--queryIndex DV_StatisticalArbitrage:Id
You can only add one index per table, but you can specify this option multiple times in a single command line in order to index multiple tables. Use this option only when you connect the viewer directly to a correlator.
|
|
-Y | --enhancedQuery
|
Make SQL-based instance tables available as data tables for visualization attachments. See Attaching dashboards to correlator data. Use this option only when you connect the viewer directly to a correlator.
|
|
-z zone | --timezone zone
|
Default time zone for interpreting and displaying dates. zone is either a Java time zone ID or a custom ID such as GMT-8:00. Unrecognized IDs are treated as GMT. See Time zone ID values for the complete listing of permissible values for zone.
|
|
--inclusionFilter val
|
Set inclusion filters. This option can occur multiple times in a single command.
|
|
--exclusionFilter val
|
Set exclusion filters. This option can occur multiple times in a single command.
|
