Preparing your worker node

Installation planning

To install a Pulse-IT-3.1 worker node, you will need at least: 

  • Windows 64 bits, 

  • 16 Go de RAM, 

  • 4 cores

  • 250 Go SSD Hard Drive

  • Access to a shared production storage (R/W)

 

On each worker node, you will install the Embrace Agent, that will manage communication between Pulse-IT server and worker 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 3.7.9 64bit (An msi installer is available in the package folder of the worker node.

IMPORTANT :
1 -  Don’t forget to add python.exe to your path by selecting the option in the installer.
2 - Check install for all users



Pywin installation

Install pywin32-228.win-amd64-py3.7 (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-3.0

 

Worker node configuration

Edit the agent.ini and change settings if needed.

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

 

 

 


Groupe

Setting

Default value

Description

[debug]

DEBUG

False

 

 

LOGLEVEL

Info

 

 [paths]

LOGDIR

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

 



TMP_DIR

[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

Will be generated by install process

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


 

 

Setup script accepts several options:

--help : to display options help

 

--upgrade

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


Uninstalling the agent

  • Start CMD.exe as an administrator
  • Change directory to the agent update folder
$ cd C:\Users\<username>\Embrace\ait_agent-3.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:\Automate-IT\logs


 

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:\Automate-IT\logs\ait_agent.log


 

Agents update

 

Updating the ag­­ent manually

To update and already installed agent : 

  • Copy the agent upgrade 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


 

Or proceed a silent update

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


 

Agent auto-update

Pulse-IT/Automate-IT lets you update the agent nodes software directly from the server interface.


Uploading an agent update

First of all, you need to upload an agent update zip package using the Administrate/Agents updates. 

You may select if update is going to be online (need an internet access) or offline (no internet connexion).


Deploying an agent update

To deploy an agent update on a list of nodes, go to Monitor/Nodes/Nodes list, select the nodes to update and click the Edit next upgrade button. Select the upgrade you want to apply and click Commit.




Update process will be executed when restarting the node instance.