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