Pools¶
Pool consists of renders and other child pools. It designed to manipulate properties (abilities) of group of render clients.
- Add/Remove/Enable/Disable services that pool renders are able to run.
- Set tickets to control how much pool renders can run together and each at the same time.
- Configure renders automatic Nimby and Free.
- Specify renders capacity and max_tasks.
- Make new renders to register in Nimby or Paused state to have some time for software installation.

AfWatch pools services and tickets
Creation¶
You can add child pool to any parent pool using GUI. Root pool will be automatically created.
Attributes¶
name¶
Pool name represents its path.
parent¶
Pool parent name (path).
time_creation¶
Time, when pool was created.
pools_num¶
Number of direct child pools.
pools_total¶
Total number of child and pools with grand childs.
renders_num¶
Number of renders in this pool.
renders_total¶
Total number of renders in this pool and renders in all child pools.
run_tasks¶
Number of total running tasks of all renders in the pool.
run_capacity¶
Total capacity of all running tasks in the pool.
task_start_finish_time¶
Time when first task was started or last task was finished.
Editable Parameters¶
annotation¶
Just some informative string that will be shown in GUI.
capacity_host¶
Pool hosts capacity.
exit_no_task_time¶
Render will exit having no task for this time.
By default it is -1
, feature is disabled.
When this parameter is changed on pool, all its renders will receive it.
heartbeat_sec¶
Renders heart beat period in seconds. Each heart beat render receives events from server, launches new tasks and processes running tasks output, sends an update message to server and receives a new events as an answer. When this parameter is changed on pool, all its renders will receive it.
max_tasks_host¶
Pool hosts maximum running tasks.
new_nimby¶
New render will be registered in NIMBY state. Useful when new host was created, Afanasy installed, but render software is not. Afanasy can be used to install render software. Maintenance job can ignore NIMBY and PAUSED render state. NIMBY state can turned off automatically.
new_paused¶
New render will be registered in PAUSED state for maintenance purposes.
no_task_event_time¶
If render has no task for this time (seconds), server will emit this event RENDER_NO_TASK
.
Next time event will be repeated after twice longer duration.
By default it is -1
, feature is disabled.
overload_event_time¶
Event RENDER_OVERLOAD
will be emitted if it has no free memory, disk or swap.
Next time event will be repeated after twice longer duration (seconds).
By default it is -1
, feature is disabled.
power_host¶
Pool hosts power. This is just any custom integer. Job can filter renders for some minimum power.
properties_host¶
Pool hosts properties. This is just any custom string. Job can filter renders for matches this string.
resources_update_period¶
Render updates resources periodically, this is number of heart beats to do it. AfWatch farm monitor will ask for renders resources according to this parameter. When this parameter is changed on pool, all its renders will receive it.
sick_errors_count¶
Number of errors from different users render considered as SICK. On any error render remembers task job user and counts them. On any success task finish this count will be reset. RENDER_SICK event can be used to notify admin that some machine can’t render.
services¶
Services names list that pool renders can run.
services_disabled¶
Disabled services names list that pool renders can not run. If some parent pool allows to run some service, you can disallow to run in child pool. Also it is useful for temporary service disabling, to not to delete service and remember that it is just disabled for some time.
tickets_pool¶
Total tickets the pool has.
For example, to limit licenses,you can set NUKE:20
tickets to the root pool.
And nuke tasks should have NUKE:1
ticket.
tickets_host¶
Each render in the pool have such tickets.
For example, to limit RAM, you can set MEM:64
tickets to some pool with renders which have 64GB RAM.
And each render in the pool can run only one task with MEM:64
tickets,
or 2 tasks with MEM:32
tickets, or 1 with MEM:32
and 3 with MEM:10
at the same time.
zombie_time¶
If server will not receive an update message from render for this time, render is considered as zombie (connection is lost) and goes to offline state.
idle_wolsleep_time¶
Time in seconds to put an idle machine to sleep. If this value is set to zero, machines will never put to sleep automatically.
idle_free_time¶
Time in seconds set an idle machine with Nimby to free. Zero or negative value disables the feature.
busy_nimby_time¶
Time in seconds set a machine with busy CPU and no Afanasy task to Nimby. Zero or negative value disables the feature.
idle_cpu¶
CPU usage percentage machine considered as idle.
busy_cpu¶
CPU usage percentage machine considered as busy.
idle_mem¶
Memory used percentage machine considered as idle.
busy_mem¶
Memory used percentage machine considered as busy.
idle_swp¶
Swap used percentage machine considered as idle.
busy_swp¶
Swap used percentage machine considered as busy.
idle_hddgb¶
Free disk space in Gigabytes machine considered as idle.
busy_hddgb¶
Free disk space in Gigabytes machine considered as busy.
idle_hddio¶
Disk I/O usage percentage machine considered as idle.
busy_hddio¶
Disk I/O usage percentage machine considered as busy.
idle_netmbs¶
Network send plus receive speed in Megabytes per second machine considered as idle.
busy_netmbs¶
Network send plus receive speed in Megabytes per second machine considered as busy.
State¶
Busy | At least one pool render runs some task |
Paused | Pool renders does not accept any tasks |