Configuration

CommandBox Service Manager
Buy Today
Search…
CommandBox Service Manager
Bullet Train Integration
Discussion & Help
Configuration
Each operating system may vary on which config items they choose to support.
You can provide configuration to the task service create and task service update commands as CLI parameters like so:
task service create startType=auto standardOutPath=logs/out.txt
Or you can put them in your task.cfc like so:
component {
​
    this.service = {
        startType : 'auto',
        standardOutPath : 'logs/out.txt'
    };
        
    function run() {
    }
​
}
The same settings available to server services also work for task services.
serviceName - The name/ID of the service
displayName - The human readable name of the service
description - The description of the service
username - The username to run as.  On Windows, format of domain\user or machine\login
password - The password of the user above (Windows only)
startType - one of the strings auto, delayed, ondemand, disabled
dependOnGroup - An array of service groups that need started first.  Comma-delimited list when passed the CLI (Windows only)
dependOnService - An array of other services that need started first.  Comma-delimited list when passed the CLI
processPriority - One of the strings realtime, high, aboveNormal, normal, belowNormal, idle (Windows only)
CPUAffinity - The string "all" or CPU IDs, starting from 0 such as "0-2,4" which would use the first, second, third, and 5th CPU core. (Windows only)
exitAction - One of the strings Restart, Ignore, Exit
restartDelayMS - Number of milliseconds to delay restart when exitAction is restart. 
restartThrottleMS - Throttles how quickly to restart if the app runs for only a short time. Set the number of milliseconds for this threshold. (Windows only)
standardOutPath - Path to a file to write the "out" logs. Similar to the server log but also includes the raw output of the server start command itself.  Useful for debugging failed starts.  (Windows only)
errorOutPath - Path to a file to write the "error" logs. Similar to the server log but also includes the raw output of the server start command itself.  Useful for debugging failed starts.  Can be set to the same path as the "out" log. (Windows only)
rotateLog - true/false to enable log rotation (Windows only)
rotateLogOnline - true/false to enable log rotation while service is running as opposed to only during a restart. (Windows only)
rotateLogSeconds - Number of seconds between log rotations. (Windows only)
rotateLogKB - Number of Kilobytes of log file size before rotating. When using online rotation, time is ignored and only file size taken into account. (Windows only)
Note, the standardOutPath and errorOutPath can be absolute or relative. When relative, the following logic is used to expand the paths.
Paths provided from the CLI are relative to the current working directory of the command
Paths provided in task.cfc are relative to the location of the task.cfc file.
On Linux, the systemd journal will be used for the server out. Any issues with startup can be viewed like so:
journalctl -u nameOfService
Usage
Bullet Train Integration
Last modified 2mo ago
Copy link
Edit on GitHub