hvrstart
Usage
hvrstart [-Rurl] [-options] hub jobs…
Description
Command hvrstart starts HVR jobs. The started jobs are run by the Scheduler. Jobs can be specified explicitly (e.g. chn-cap-locx) or partially (e.g. chn-cap, which matches all capture jobs). If only a channel (chn) name is specified, hvrstart runs the capture jobs (chn-cap) and then the integrate jobs (chn-integ).
Command hvrstart will not start the jobs in the SUSPEND state unless option -u is used. Jobs in the FAILED or RETRY states will not be started unless option -r is used. In this mode, the Scheduler process must already be running. If the job is already running, then the Scheduler will force the job to wake up and perform a new replication cycle.
Options
This section describes the options available for command hvrstart.
| Parameter | Description |
|---|---|
-i | Run jobs directly in the command line instead of via the Scheduler. The job output and errors are sent to stdout and stderr. Note that replication jobs (capture/integrate) will run only one cycle.
|
-r | Retry jobs in the FAILED or RETRY states by triggering them with value 2 in column job_trigger of the HVR_JOB repository table. This option cannot be combined with option-i. |
-Rurl | Remote hub server. Access the hub server running on a remote machine, via the REST interface. This option is required for remote CLI access. When using this option, command hvrlogin should be run first, for authentication. |
-u | Start jobs in SUSPEND state. This option cannot be combined with option-i. |
-w | Wait until all of the selected running jobs have finished or have completed a full replication cycle. While hvrstart is waiting for a job, its output is carbon-copied to the stdout and stderr of the hvrstart command. This option cannot be combined with option-i. |
Examples
This section provides examples of using the hvrstart command.
Example 1. Start capture job
The following command starts a capture job:
hvrstart hub chn-cap-loc
Example 2. Start integrate job
The following command starts all integrate jobs:
hvrstart hub chn-integ
Example 3. Start capture and integrate jobs
The following command starts all capture jobs and then all integrate jobs:
hvrstart hub chn
Example 4. Start refresh job
The following command starts a refresh job:
hvrstart hub chn-refr-loc1-loc2