Preparing your worker node

Installation planning

To install a Automate-IT-2.5 worker node, you will need at least

  • Windows 64 bits, 

  • 32 Go de RAM, 

  • 8 cores

  • 250 Go SSD Hard Drive

  • Nvidia GPU Quadro mid-range

  • Access to a shared production storage (R/W)
  • Adobe After Effects CC2018 and newer
  • Adobe Media Encoder CC2018 and newer


Fonts required by your Adobe After Effects templates projects have to be installed on each render node. 



On each render node, you will install the Embrace Agent, that will manage communication between Automate-IT server and render nodes.

 

Open the firewall on the following ports:

80                        http

443                      https

4369                    epmd, a peer discovery service used by RabbitMQ nodes and CLI tools

5672, 5671          used by AMQP 0-9-1 and 1.0 clients without and with TLS

Note: Ports should be opened in both ways


Python installation

First of all, install Python 2.7.10 64bit (An msi installer is available in the package folder of the worker node.

IMPORTANT : Don’t forget to add python.exe to your path by selecting the option in the installer.



Pywin installation

Install Pywin32-220 (An msi installer is available in the package folder of the agent installation package..

 

 

Worker node installation

IMPORTANT:   The Windows user name should not contain spaces.

 Preparing the install

  • Create an Embrace folder
C:\Users\<username>\Embrace

 

  • Copy the agent installer file in it
Embrace
   |---- ait_agent-2.5

 

Worker node configuration

Edit the agent.ini and change settings if needed.

Embrace
   |---- ait_agent-2.5
        |---- ait_agent
              |---- conf
                    |---- agent.ini

 

 

 


Groupe

Setting

Default value

Description

[debug]

DEBUG

False

 

 

LOGLEVEL

Info

 

 

LOGDIR

C:\Program Files\Automate-IT\ait_agent-2.0\logs

 

[email]

EMAIL_HOST

smtp.gmail.com

 eMail sender configuration

 

EMAIL_PORT

25

 

 

EMAIL_HOST_USER

 

 

 

EMAIL_HOST_PASSWORD

 

 

 

EMAIL_USE_TLS

True

 

 

EMAIL_SENDER

 

 

[rabbitmq]

RABBITMQ_HOST

 

RabbitMQ Address

 

RABBITMQ_SSL

 True

 

[ae_agent]

SERVER_ADDRESS

Will be generated by install process

Server address with protocol (http:// or https://

 

SERVER_USER

 Will be generated by install process

Pulse-IT user name used to connect to Pulse-IT

 

SERVER_PASSWORD

 Will be generated by install process

 Encoded password

 

NODE_NAME

 "RENDER_NODE"

 A unique name for this worker node.

 

 

 

 

Worker node installation

  • Open cmd.exe as an administrator and set current directory to the agent installation folder
  • Execute the setup.py script.



$ python setup.py --online
HTML



 

 

Setup script accepts several options:

--help : to display options help

 

--upgrade

This option is going to upgrade the agent itself and all the linked libraries

--upgrade_ait

This option is going to upgrade only the agent code without updating the python libraries

--online

Online option will force the installer to download python libraries from Internet.

--domain, --username, --password : 

Let you set the credentials in order to make a silent installation 

--override_cfg

Replace agent.ini file by the one in your installation folder.


--update_server_info

This option will let you reenter the server address as well as username and password.

 

--update_server_pwd

Let you reenter the password used by agent to connect to the server.


 

Checking the agent installation  

After installation, you should find 4 new services installed in your system.

AIT_Agent_xxx should have a status “Started”, or “Execution in progress”

 

You can check the Event Viewer/Windows log/Application.  Sources starting with AIT_AGENT_xxx should not generate errors.

 

!! Warning: First installation

If Embrace services are not started after installation:   

  • Right-click on one Embrace service
  • Click “Properties”
  • Choose the “Log on” tab
  • Re-enter the account credentials
  • Restart all Embrace Services.

In case of error during the process, please refer to the “Troubleshooting” section

 

Updating the ag­­ent

To update and already installed agent : 

  • Copy the agent uprade folder in the Embrace folder
  • Start CMD.exe as an administrator
  • Change directory to the agent update folder
  • Upgrade the agent
$ python setup.py --upgrade
HTML


 

Ou Lancer les mises à jour silencieuses

$ python setup.py –upgrade --username <user> --password <pwd> [--domain <domain>]
HTML


 

Uninstall the agent

  • Start CMD.exe as an administrator
  • Change directory to the agent update folder
$ cd C:\Users\<username>\Embrace\ait_agent-2.0
  • Uninstall the agent
$ python setup.py --uninstall

 

Checking Agent services status

  • Open “Services” app
  • Check if the 4 services named “AIT_Agent_xxx” are up and running.


 

 


Agent’s log checking

In the « Event Viewer »

  • Open the « Event Viewer » app
  • Select « Windows Logs » and « Application »
  • Agent’s logs are displayed using source « AIT_Agent_* »

 

In the agent’s logs

  • Agent’s logs files are located in the directory set in [paths]LOGS_DIR
C:\Program Files\Automate-IT\ait_agent-2.0\logs
HTML


 

In case of installation error

  • Check logs in « Event Viewer »
  • Check logs in installation log
C:\Users\<username>\Automate-IT\ait_agent-2.0\install.log

C:\Program Files\Automate-IT\ait_agent-2.0\logs\ait_agent.log
HTML


Install Adobe After Effects agent extension

Adobe After Effects must be installed before you install the agent extension

Execute AIT_AE_agent_1.xx.msi provided by Embrace support.

This extension allow Automate-IT workflow engine to communicate with Adobe After Effects.

No special action is asked during the setup.


Install Adobe Media Encoder agent extension

Adobe Media Encoder must be installed before you install the agent extension

Execute AIT_AME_agent_1.xx.msi provided by Embrace support.

This extension allow Automate-IT workflow engine to communicate with Adobe Media Encoder.

No special action is asked during the setup.