Uso de Toonz Farm¶

Toonz Farm permite procesar escenas de OpenToonz enviadas como tareas de limpieza o de procesamiento a la lista de tareas usando una serie de computadoras conectadas a una misma red mediante TCP/IP (ver Limpieza de dibujos en modo por lotes y Procesamiento de escenas en modo por lotes ).

Cuando las tareas son ejecutadas, son asignadas automáticamente a las computadoras pertenecientes a la granja para balancear la carga de trabajo. Cuando todas las computadoras se encuentren ocupadas, las tareas restantes no serán asignadas hasta que una de ellas se encuentre lista para procesarlas.

Nota

Si se hubiera dividido una tarea de procesamiento en bloques, cada bloque será asignado a una computadora distinta de la red, agilizando así el procesamiento de la misma (ver Uso de bloques en tareas de procesamiento ).

Toonz Farm está compuesto por lo siguiente:

Nodo controlador: es la computadora que envía las tareas a los nodos servidores (procesadores). Esta computadora debe tener corriendo el programa controlador, llamado tfarmcontroller.exe en Windows o tfarmcontrollerd en macOS. Es necesario contar con un nodo controlador para poder definir una granja de procesamiento.

Nota

El nodo controlador también puede ser usado como nodo servidor (procesador).

Nodos servidores (procesadores): son computadoras que procesan las tareas enviadas por el nodo controlador. Cada una de estas computadoras debe tener corriendo un programa servidor, llamado tfarmserver.exe en Windows o tfarmserverd en macOS, que se encarga de ejecutar las tareas, notificando al nodo controlador cuando una tarea haya sido completada, etc.
Carpeta principal llamada FARMROOT: es una carpeta compartida donde se almacena una serie de archivos de configuración. El nodo controlador y todos los nodos procesadores deben poder acceder a esta carpeta compartida (ver Configuración de Toonz Farm ).
Programa cliente: es el programa ejecutado por el usuario para agregar nuevas tareas a la lista, así como para monitorear la granja de Toonz Farm. El propio OpenToonz es el programa cliente de Toonz Farm, y puede ser ejecutado en cualquier computadora de la red (que no tiene por qué necesariamente ser un nodo servidor (procesador) o controlador).

Nota

Para poder procesar las escenas exitosamente todas las computadoras relacionadas con Toonz Farm (controlador, servidores y clientes) deben compartir las mismas carpetas principales de proyectos (ver Definición de la carpeta principal de proyectos ).

Instalación de Toonz Farm en Windows¶

Para instalar Toonz Farm, es necesario instalar el componente de Controlador en la computadora que funcionará como nodo controlador, y el componente de Servidor en las computadoras que servirán como nodos servidores (procesadores).

Nota

Si se desea usar una misma computadora tanto como nodo controlador como servidor, será necesario instalar allí ambos componentes.

Durante la instalación de cualquiera de los componentes se debe especificar la ruta completa a la carpeta principal FARMROOT. Esta ruta debe ser expresada en formato UNC, como se indica a continuación:

\\Nombre del servidor\Nombre del recurso compartido\Nombre de la carpeta

El disco donde se encuentre la carpeta FARMROOT tiene que estar compartido en la red, otorgando control completo a cualquier usuario, mediante el uso de los permisos apropiados.

Cuando se elige instalar el componente del Controlador, la instalación creará un Servicio de Windows para el programa controlador, llamado Toonz Farm Controller.

Al elegir instalar el componente del Servidor, el programa de instalación creará un programa Servicio de Windows, llamado Toonz Farm Server.

Nota

Como Toonz Farm necesita intercambiar datos entre las computadoras de la red, usando el protocolo TCP/IP, cualquier sistema de cortafuegos que pueda bloquear el acceso a los puertos de la computadora tendrá que ser deshabilitado o permitir el libre acceso a los puertos usados por Toonz Farm.

Configuración del nodo Controlador¶

En el nodo controlador el componente controlador es instalado como un servicio de Windows, llamado Toonz Farm Controller. De forma predefinida un Servicio de Windows se ejecuta bajo las credenciales de seguridad de la cuenta Sistema local. De forma predefinida esta cuenta no cuenta con derecho a acceder carpetas compartidas por servidores remotos.

Como el servicio Toonz Farm Controller necesita acceder a la carpeta principal FARMROOT, usualmente compartida desde un servidor remoto, es necesario ejecutar este servicio desde un usuario con los permisos apropiados.

Nota

Es posible iniciar el servicio desde una línea de comandos de DOS navegando hasta la carpeta donde se encuentran instalados los binarios de OpenToonz, y allí usar el siguiente comando:tfarmcontroller -console

Truco

Para ejecutar el Controlador de Toonz Farm como un usuario con los permisos apropiados:

Elegir Panel de control → Sistema y seguridad → Herramientas administrativas → Servicios, y hacer clic derecho sobre el servicio Toonz Farm Controller para abrir su diálogo de Propiedades.
Seleccionar la solapa Iniciar sesión, marcar la opción Esta cuenta:.
Elegir la red donde Toonz Farm va a funcionar y una cuenta que cuente con permisos de administrador en la misma. Ingresar y confirmar la contraseña correspondiente.
Hacer clic en el botón Aceptar.

Configuración de los nodos Servidores¶

En los nodos servidores el componente servidor es instalado como un servicio de Windows, llamado Toonz Farm Server. De forma predefinida un Servicio de Windows se ejecuta bajo las credenciales de seguridad de la cuenta Sistema local. De forma predefinida esta cuenta no cuenta con derecho a acceder carpetas compartidas por servidores remotos.

Como el servicio Toonz Farm Server, para sus propósitos de procesamiento, necesita acceder a una o más carpetas compartidas desde servidores remotos, es necesario ejecutar este servicio desde un usuario con los permisos apropiados.

Nota

Es posible iniciar el servicio desde una línea de comandos de DOS navegando hasta la carpeta donde se encuentran instalados los binarios de OpenToonz, y allí usar el siguiente comando:tfarmserver -console

Truco

Para ejecutar el Servidor de Toonz Farm como un usuario con los permisos apropiados:

Elegir Panel de control → Sistema y seguridad → Herramientas administrativas → Servicios, y hacer clic derecho sobre el servicio Toonz Farm Server para abrir su diálogo de Propiedades.
Seleccionar la solapa Iniciar sesión, marcar la opción Esta cuenta:.
Elegir la red donde Toonz Farm va a funcionar y una cuenta que cuente con permisos de administrador en la misma. Ingresar y confirmar la contraseña correspondiente.
Hacer clic en el botón Aceptar.

Instalación de Toonz Farm en macOS¶

Para instalar Toonz Farm, es necesario instalar el componente de Controlador en la computadora que funcionará como nodo controlador, y el componente de Servidor en las computadoras que servirán como nodos servidores (procesadores).

Nota

Si se desea usar una misma computadora tanto como nodo controlador como servidor, será necesario instalar allí ambos componentes.

Luego de la instalación de los componentes de Toonz Farm, es necesario definir una carpeta principal FARMROOT, y en todas las computadoras pertenecientes a la granja (tanto controlador como servidores) se debe especificar la ruta completa a la carpeta FARMROOT.

Es posible tomar como modelo para definir la carpeta principal FARMROOT a la carpeta toonzfarm almacenada en OpenToonz stuff. Es posible tomar la carpeta toonzfarm de cualquier computadora donde se encuentre instalado OpenToonz, elegir una ubicación preferida y compartirla en la red, otorgando control total a todos los usuarios, por medio de los permisos apropiados.

Para especificar la ruta a la carpeta principal FARMROOT en las computadoras (tanto controlador como servidores) pertenecientes a la red, es necesario editar el archivo configfarmroot.txt ingresando en el mismo la ruta completa a la carpeta FARMROOT.

Para recuperar este archivo abrir la carpeta Applications/OpenToonz, hacer clic derecho sobre el ícono de OpenToonz y elegir Mostrar Contenido del Paquete en el menú; en la carpeta que se abre navegar hasta la carpeta Contents/Resources y recuperar el archivo configfarmroot.txt .

Nota

Como Toonz Farm necesita intercambiar datos entre las computadoras de la red, usando el protocolo TCP/IP, cualquier sistema de cortafuegos que pueda bloquear el acceso a los puertos de la computadora tendrá que ser deshabilitado o permitir el libre acceso a los puertos usados por Toonz Farm.

Configuración de Toonz Farm¶

Una vez que se ha completado la instalación, es necesario configurar Toonz Farm mediante la edición de algunos archivos de configuración almacenados en la carpeta FARMROOT.

La carpeta FARMROOT debe estar accesible desde todos los nodos que componen la granja de Toonz Farm: el nodo controlador, los nodos servidores (procesadores) y las computadoras que corren OpenToonz. Esto significa que el disco donde se encuentre ubicada la carpeta principal FARMROOT debe estar compartido en la red y los permisos para los usuarios deben estar al máximo, para poder darle control total a cualquiera de ellos.

Por la misma razón la computadora donde se encuentre ubicada la carpeta FARMROOT tiene que encontrarse en funcionamiento con anterioridad a las demás computadoras de la granja.

La carpeta FARMROOT contiene lo siguiente:

la carpeta config conteniendo los archivos servers.txt , controller.txt y id.txt .
la carpeta logs .

Es necesario editar los archivos de configuración controller.txt y servers.txt para definir el nodo controlador y los nodos servidores (procesadores) antes de poder usar la granja de procesamiento.

Definición del nodo Controlador¶

El nodo controlador se define en el archivo de configuración controller.txt ubicado en la carpeta FARMROOT\config .

El archivo debe contener una única línea de texto que describa el nodo que se desee usar como nodo controlador.

Para el nodo controlador debe especificarse lo siguiente:

Nombre del equipo.
Dirección IP.
El número del puerto que se desee usar para el servicio del controlador.

Nota

Es necesario asegurarse de que el puerto establecido no se encuentre bloqueado por ningún sistema cortafuegos, y que se encuentre abierto para todas las computadoras pertenecientes a la granja de Toonz Farm.

Los datos arriba mencionados deben estar separados entre ellos por un único espacio. Debajo se muestra un ejemplo de archivo controller.txt :

render1 10.10.0.130 10000

En el ejemplo de arriba, render1 es el nodo controlador, su dirección IP es 10.10.0.166 y el programa controlador usará el puerto 10000 .

Definición de los nodos Servidores¶

Los nodos servidores (procesadores) se definen en el archivo de configuración servers.txt ubicado en la carpeta FARMROOT\config .

El archivo debe contener una línea de texto por cada computadora que se desee usar como nodo servidor (procesador).

Para cada nodo servidor debe especificarse lo siguiente:

Nombre del equipo.
Dirección IP.
El número del puerto que se desee usar para el servicio del servidor.

Nota

Es necesario asegurarse de que el puerto establecido no se encuentre bloqueado por ningún sistema cortafuegos, y que se encuentre abierto para todas las computadoras pertenecientes a la granja de Toonz Farm.

Los datos arriba mencionados deben estar separados entre ellos por un único espacio. Debajo se muestra un ejemplo de archivo servers.txt

render1 10.10.0.166 8002
render2 10.10.0.195 8002
render3 10.10.0.111 8002
render4 10.10.0.180 8002

En el ejemplo de arriba, render1 es un nodo servidor, su dirección IP es 10.10.0.166 y el programa servidor usará el puerto 8002 ; render2 es un nodo servidor, su dirección IP es 10.10.0.195 y el programa servidor usará el puerto 8002 ; etc.

Si se desea agregar o eliminar un nodo servidor (procesador) del archivo servers.txt , será necesario reiniciar el nodo controlador para hacer efectivos los cambios.

Definición de la granja de Toonz Farm en OpenToonz¶

OpenToonz es el programa cliente de Toonz Farm: permite enviar nuevas tareas y monitorear el estado de la granja.

Si la computadora donde se ejecuta OpenToonz ya es un nodo controlador o servidor (procesador) de Toonz Farm, no será necesario realizar ninguna tarea adicional de configuración.

Si la computadora donde se ejecuta OpenToonz no fuera un nodo controlador o servidor (procesador) de Toonz Farm, será necesario definir la carpeta principal FARMROOT.

Truco

Para definir la carpeta FARMROOT en OpenToonz:

Ejecutar OpenToonz e ir al espacio de trabajo Farm.
En el panel Servidores de tareas, en el menú de opciones Procesar con: elegir Granja de procesamiento.
En el diálogo que se abre especificar la ruta completa a la carpeta principal FARMROOT.
Hacer clic en el botón Aceptar.

Uso de Toonz Farm¶

En OpenToonz es posible encontrar el espacio de trabajo Farm que permite monitorear los procesos de la granja. Este espacio de trabajo contiene dos paneles principales: Tareas y Servidores de tareas.

La granja de procesamiento puede ser monitoreada usando tanto el panel Tareas, donde es posible administrar y ejecutar la lista de tareas, como el panel Servidores, donde es posible administrar las computadoras que procesan las tareas.

Nota

Todos los discos involucrados en el procesamiento de las tareas (p.ej: discos donde deban guardarse archivos producidos por el procesamiento de las tareas) deberán estar compartidos otorgando permisos completos a todos los usuarios, de otro modo es posible que la ejecución de las tareas no sea exitosa. En Windows, los discos deben tener Control total para Todos; en macOS las opciones de compartición deben permitir que cualquier usuario sea capaz de leer y escribir en los discos.

Monitoreo de nodos Servidores¶

El panel Servidores de tareas está dividido en tres áreas: en al área superior hay un menú de opciones para definir si la ejecución de las tareas debe ser realizada usando la computadora Local o la Granja de procesamiento; más abajo se encuentra la lista de nodos servidores (procesadores) disponibles en la granja; en el área inferior es posible ver información acerca del servidor seleccionado en la lista.

Los nodos servidores (procesadores) incluidos en la lista son aquellos definidos en el archivo de configuración server.txt (ver Definición de nodos Servidores ). Si un nodo servidor se encontrara fuera de línea en el momento de iniciar el nodo controlador, éste no estará disponible en la granja: esto significa que todos los nodos servidores deberán estar disponibles con anterioridad al inicio del nodo controlador. Por la misma razón, si se deseara reiniciar o apagar uno de los nodos servidores (procesadores), será también necesario reiniciar el nodo controlador para que dichos cambios sean efectivos.

Si el menú de opciones Procesar como: se encuentra en Local, todas las tareas que se ejecuten serán procesadas por la computadora local; si en cambio se encontrara en Granja de procesamiento, las tareas serán ejecutadas por la granja de Toonz Farm.

Nota

Es posible que al seleccionar Granja de procesamiento se solicite definir la carpeta principal FARMROOT (ver Definición de la granja de Toonz Farm en OpenToonz ).

Cuando se selecciona un servidor en la lista, se muestra la siguiente información relacionada con el mismo en el área inferior del panel:

Nombre: muestra el nombre de ese nodo servidor (procesador).
Dirección IP: muestra su dirección IP.
№ de puerto: muestra el número del puerto usado para intercambiar datos con la granja.
Tareas: muestra la tarea que está siendo ejecutada.
Estado: muestra si el servidor se encuentra Listo, Ocupado o Fuera de línea.

Nota

El estado de un nodo servidor puede aparecer como Fuera de línea si el puerto establecido para el servidor se encontrara bloqueado por un sistema de cortafuegos, y por lo tanto no se encontrara abierto para todas las computadoras de la granja de Toonz Farm (ver Definición de nodos Servidores ).

Cantidad de CPU: muestra la cantidad de núcleos de procesador disponibles en ese servidor.
Memoria física: muestra la cantidad de memoria física disponible en ese servidor.

Truco

Para usar la computadora Local para ejecutar tareas:

Definir el menú de opciones Procesar con: en Local.

Truco

Para usar Toonz Farm para ejecutar tareas:

Definir el menú de opciones Procesar con: en Granja de procesamiento.

Comprobación del procesamiento con Toonz Farm¶

Al usar la granja de Toonz Farm, cualquier problema que pudiera experimentarse durante el procesamiento será registrado en archivos LOG; los mismos pueden ser abiertos y utilizados para diagnosticar un problema.

Los archivos LOG se almacenan en la carpeta OpenToonz stuff\toonzfarm de la computadora que experimentó el problema; cada archivo LOG se refiere únicamente al procesamiento realizado por esa computadora.

Los archivos LOG que pueden ser generados por Toonz Farm son los siguientes:

server.log registra todas las operaciones relativas a la actividad de la computadora actuando como servidor.
controller.log registra todas las operaciones relativas a la actividad de la computadora actuando como controlador.
tcomposer.log registra todas las operaciones relativas a procesamiento de las computadoras que actúan como servidores.
tcleanup.log registra todas las operaciones relativas a limpieza de las computadoras que actúan como servidores.