hvrrouterconsolidate
Usage
hvrrouterconsolidate [-options]... hub [chn]
Description
Command hvrrouterconsolidate merges together small transaction (tx) files present in the router directory. If capture jobs run without integrate jobs then many transaction files (matching *.tx_integloc) will accumulate in the $HVR_CONFIG/hubs/hub/channels/channel/locs/loc/router/ directory. These files can cause extra CPU load in other jobs. Small transaction files will also accumulate in the $HVR_CONFIG/hubs/hub/channels/channel/locs/loc/jnl/ directory if action Integrate with parameter JournalRouterFiles is defined.
Consolidation will not merge all small files; the algorithm instead processes files in batches of 10, 100, 1000, etc.
Consolidation is unsafe when an integrate job is running. For this reason, command hvrrouterconsolidate will only consolidate router files for integrate jobs that have the SUSPEND or FAILED or PENDING states under the Scheduler (unless option -f is supplied).
If the channel name is not supplied, the router consolidation will be done for all channels.
Options
This section describes the options available for command hvrrouterconsolidate.
| Parameter | Description |
|---|---|
-f | Consolidate files for all jobs regardless of the jobs' state. Only used when the Scheduler is not running. |
-j | Consolidate files in the /jnl directory only and ignore the /router directory. |
-llocscope | Consolidate files in specific locations only. Valid values for
|
-Nnrows | Maximum number of rows (nrows) in the files to be consolidated. Larger files will not be merged. |
-p | Only print OS commands, without executing them. |
-r | Consolidate files in the /router directory only and ignore the /jnl directory. |
-sfsize | Maximum size ( defaultsize is 20Mb. |
Examples
This section provides examples of using the hvrrouterconsolidate command.
Example 1. Consolidate files in the /jnl directory
The following command consolidates files in the /jnl directory only and ignores the /router directory.
hvrrouterconsolidate -j myhub mychannel
Example 2. Only print OS commands
The following command prints the OS commands equivalent to those that option -f would execute.
hvrrouterconsolidate -p myhub mychannel
Example 3. Consolidate files in the /router directory
The following command consolidates files in the /router directory only and ignores the /jnl directory.
hvrrouterconsolidate -r myhub mychannel
Example 4. Consolidate files for all jobs regardless of their state
The following command consolidates files for all jobs regardless of the jobs' state.
hvrrouterconsolidate -f myhub mychannel
Example 5. Consolidate files based on their size
The following command consolidates files with a maximum size of 100000 bytes in the /router directory.
hvrrouterconsolidate -r -s 100000 myhub mychannel
Example 6. Consolidate files based on the number of lines
The following command consolidates files in the /router directory that have no more than 8000 lines in each.
hvrrouterconsolidate -r -N 8000 myhub mychannel
Example 7. Consolidate files for a specific location
The following command consolidates files in the /jnl directory for location myloc.
hvrrouterconsolidate -j -l myloc myhub mychannel
Example 8. Consolidate files for all channels
The following command consolidates files in the /router directory for all channels on the hub.
hvrrouterconsolidate -r myhub