Configuring the Agent

You can configure OVMS agents (add and delete agent instances) by using your editor to open the tagent.ini file and making changes as needed.

Configuring Agent Parameters

Certain parameters of the OVMS agent can be configured for the convenience of users. You modify the parameters of an agent by changing the parameter values in the tagent.ini file. The tagent.ini file is located in the OVMS agent directory. Stop the agent before modifying any of the agent’s parameters. These agent parameters can be modified:

  • homedir=y

    The homedir parameter specifies the agent’s home directory.

    The y value means that the starting path will be the runtime user’s home directory instead of the agent’s home directory.

    Leaving the parameter value blank (the default value) or specifying a n value means that the home directory remains the directory where the agent is installed.

    Note: This parameter will override the working directory setting in the master for all jobs to the user’s home directory.

  • minmem=x and maxmem=x

    The minmem and maxmem parameters control how many MB of memory should be allocated to the agent processes. These memory parameters can be adjusted as individual needs warrent. Your system may need more or less than the default memory allotments.

    The minmem parameter specifies that at least the amount of RAM specified should be available. The default value is 16 MB of RAM.

    The maxmem parameter specifies that no more than the amount of RAM specified should be available for the agent processes. The default value is 32 MB of RAM.

  • Jobstopwait=n seconds

    The Jobstopwait parameter specifies the time interval between sending a SIGTSTP warning that a job is about to be put on hold and actually sending the SIGSTOP signal to pause the job.

    The default value is 1 second before pausing the job but the number of seconds between the warning and the actual pausing of the job can be modified from this parameter.

  • Jobkillwait=n seconds

    The Jobkillwait parameter specifies the time interval between sending a SIGTERM warning that a job is about to be aborted or cancelled and actually sending the SIGKILL signal to abort or cancel the job.

    The default value is 5 seconds before cancelling the job but the number of seconds between the warning and the actual cancelling of the job can be modified from this parameter.

Starting and Stopping Agents

Start an agent by entering on the command line:

$ tagent <agent name> debug (interactive mode)

OR 

$tagentdetach (detach mode)

Stop the agent by entering on the command line:

$ tagent <agent name> stop

Note: You should stop all OVMS agents before rebooting the OVMS system. It is recommended to add the agent stop command to a system shutdown script to be used when restarting an OVMS system.