Qlik Replicate: Repctl Stop Start Task using REPCTL command line interface

[Michael_Litz]

The listed commands are unsupported by Qlik Replicate. The commands work, but Qlik cannot give a guarantee that they will continue to function in the future. 

If you do not have Qlik Enterprise Manager (QEM), then this is the option to script task starts and stops. If you do have QEM please look into using the restAPI calls to do the same things. You can reference the QEM developer's guide for information on this API.

To note:

• The repctl command is accessed from the directory \Attunity\replicate\bin
• Always run the command lines as Administrator.

You can start the task multiple ways based on the following parameters and flags:

Parameters:

1 = Start Full Load only
2 = Start Change Capture only
3 = Start Both

Flags Values:

0 = Resume
1 = Fresh Start (like starting as of now)

Three commands to start a task, check task statuses, or stop tasks:

Start a task:

repctl connect; execute task_name 3 Flags=0; disconnect

Get task status:

repctl connect; gettaskstatus task_name; disconnect

Stop a task:

repctl connect; stoptask task_name; disconnect

Notes:

• When running a full load only task you may want to have the batch file wait until the load completes:
  

  Repctl execute task=<task_name> 1 flags=1

• When running these commands in a batch file (maintenance job) you will want to do the Stop command followed by a loop that checks the status of the task (until it does stop)
• The execute command may take up to several minutes to complete

To run the command on a remote replicate machine:

repctl connect ip=192.168.165.11 port=3552 ; stoptask task; disconnect

Alternate (non-default) data directories must be provided using -d <path>
Alternatively in Windows use: ?set AREP_DATA=<path>

If the Replicate data folder is on another location you would need to set the path for repctl.

Example:

repctl.exe  -d "E:\Attunity\Replicate\data" connect;

To run this on Linux you may need to add a back slash in front of the semi-colon:

repctl connect\; gettaskstatus task_name\; disconnect

In addition, while using Linux shell, you have to escape the semicolons with backslashes. 

Example:

?./repctl connect\; gettaskstatus task_name\; disconnect

Further note on usage: be certain to have blank space following the semi-colon command delimiter.

Environment

• Qlik Replicate command line using repctl

The information in this article is provided as-is and to be used at own discretion. Depending on tool(s) used, customization(s), and/or other factors ongoing support on the solution below may not be provided by Qlik Support.

[humanadba]

When using the repctl command to stop/start task is default port 3552?

[Sonja_Bauernfeind]

Hello @humanadba 

The Qlik Replicate Console default port is 3552, yes. See Accessing Qlik Replicate from a remote computer.

All the best,
Sonja