Preparing your worker node

Installation planning

To install a Pulse-IT-2.5 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 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


 

 

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


 

Ou Lancer les mises à jour silencieuses

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


 

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


 

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