p4 bgtask

Run background commands or triggers on the server.

Syntax conventions 

p4 bgtask [-b -d -i -m -w] [-e -t ]

Description

Enables a superuser on the p4 command-line client to run commands or programs remotely on the server in the background.
The server saves output to the server log file.

Tip

To minimize memory consumption on the server, a long-running task should minimize its output to standard output and standard error.

The superuser defines the commands in the triggers table (with -t) or as string arguments on the command line (with -e). Supports setting startup commands, replication pull commands, for a specific serverId. The superuser can specify an interval for re-running the command.

See also Defining background tasks in the triggers table in the Helix Core Server Administrator Guide.

Options

-b

Maximum number of execution errors before ceasing to attempt execution. The default is 1.

-d

Detach the client, which means the client does not see the output of the server-side task execution. This is particularly useful for a task that runs for a long period of time. See About detached mode.

-e

Command string to execute.

-i

Seconds between command invocations. The default is 1 second. The maximum is 31 days.

-m

Maximum number of times the command is run. The default is 1.

-t

Name of the background trigger in the triggers table to execute.

-w

Seconds to pause after execution error before attempting the next execution. The default is 5.

Usage Notes

Can File Arguments Use Revision Specifier? Can File Arguments Use Revision Range? Minimal Access Level Required

N/A

N/A

super

About detached mode

In detached mode, bgtask creates two separate pairs of log entries:

2017/10/04 14:20:35 pid 22735 user@ws0 127.0.0.1 [p4/2014.1.main/LINUX26X86_64/576838] 'user-cron -m 5 -d -i 1 -c perl foreground_detached.pl'
2017/10/04 14:21:35 pid 22735 completed .001s 0+0us 0+0io 0+0net 2140k 0pf
2017/10/04 14:20:35 pid 22735 user@ws0 background [p4/2014.1.main/LINUX26X86_64/576838] 'user-cron -m 5 -d -i 1 -c perl foreground_detached.pl'
2017/10/04 14:20:46 pid 22735 completed 10.1s 0+4us 0+8io 0+0net 2164k 0pf

The first two lines record the start and end for the user portion of the command.

The final two lines record the start and end for the background portion.

Examples

startup.1=bgtask -t log_checker Upon server startup, run the log_checker task in the background. (See the startup.N configurable)

p4 bgtask -t verify

Immediately runs a background task that executes the verify trigger that the superuser has already defined in the triggers table.

p4 bgtask -d -i 86400 -m 5 -t p4dstate

Run the specified trigger every day. (A day has 86400 seconds.)

p4 bgtask -e "top -b -n 1"

Sample the server load.
p4 bgtask -e "powershell -Command Import-Csv C:\p4root\errors.csv"

See the errors that have been logged.