Preparing your worker node
Installation planning
To install a Pulse-IT/Automate-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 agent 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.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article