public interface VanillaSoftwareProcess
extends AbstractVanillaProcess

A SoftwareProcess entity that runs commands from an archive.

Downloads and unpacks the archive indicated (optionally) then runs the management commands (scripts) indicated (relative to the root of the archive if supplied, otherwise in a tmp working dir) to manage. Uses config keys to identify the files or commands to use.

In the simplest mode, simply provide either:

• an archive in AbstractVanillaProcess.DOWNLOAD_URL containing a ./start.sh
• a start command to invoke in LAUNCH_COMMAND

The only constraint is that the start command must write the PID into the file pointed to by the injected environment variable PID_FILE unless one of the options below is supported.

The start command can be a complex bash command, downloading and unpacking files, and handling the PID_FILE requirement. For example export MY_PID_FILE=$PID_FILE ; ./my_start.sh or nohup ./start.sh & ; echo $! > $PID_FILE ; sleep 5. You can supply both AbstractVanillaProcess.DOWNLOAD_URL and LAUNCH_COMMAND configuration as well..

In addition, you can supply an AbstractVanillaProcess.INSTALL_COMMAND and / or a AbstractVanillaProcess.CUSTOMIZE_COMMAND to reduce the complexity of the LAUNCH_COMMAND, and to avoid repeating actions that are unnecessary in subsequent launches.

By default the PID is used to stop the process using kill followed by kill -9 if needed and restart is implemented by stopping the process and then running VanillaSoftwareProcessSshDriver.launch(), but it is possible to override this behavior through config keys:

• A custom AbstractVanillaProcess.CHECK_RUNNING_COMMAND
• A custom AbstractVanillaProcess.STOP_COMMAND
• A different SoftwareProcess.PID_FILE to use