Skip to main content

Installing Pulse-IT/Automate-IT Worker on Windows

Requirements To install Pulse-IT/Automate-IT Worker on Windows, you need:

  • Pulse-IT/Automate-IT server running
  • A Windows server or Windows 10
  • At least 16 GB of RAM (more may be required depending on the tasks you run)
  • At least 250 GB of free disk space
  • Access to a shared storage (R/W).

Installation

Preparation steps:​

  1. Create a destination directory (e.g. C:<user>\Embrace)
  2. Copy the installation folder into the destination directory
  3. Unzip the installation folder
  4. Install Python and Pywin32:
    1. Enter the installation folder > packages
    2. Install Python using the provided Python installer. Check the checkbox Add Python 3.9 to PATH
    3. Install Pywin32 using the provided Pywin32 installer

Install worker​

  • Powershell console as Administrator
  • Enter into installer directory
cd C:\path\to\installer

Run the installer​

python.exe .\setup.py --online

The script will then prompt you to enter the Windows user domain, username, and password.

Then after installing all required dependencies, the script will prompt you to enter the Pulse-IT/Automate-IT server information.

The worker can be installed in non-interactive mode using the following command:

  python.exe .\setup.py --online \
      --domain <windows-user-domain> \ 
      --username <windows-username> \ 
      --password <windows-password> \
      --server-host <pulse-it-automate-it-host-address> \
      --server-user <pulse-it-automate-it-user> \
      --server-password <pulse-it-automate-it-password> \
      --rabbitmq-host <rabbitmq-host> \
      --rabbitmq-user <rabbitmq-user> \
      --rabbitmq-password <rabbitmq-password>

Note:

  • If domain, rabbitmq-user or rabbitmq-password are empty, the corresponding option can be omitted
  • Ensure the server-host value includes the protocol, either http:// or https://

Check Worker is properly installed​

  1. Check the Worker services are properly running
  • Click on windows Start button
  • Search for "Services"
  • Open services application
  • All the listed worker services should be in a running state windows-services.png
  1. Check the Worker is properly registered on Pulse-IT/Automate-IT
  • Open a web browser and navigate to http://{your-server-ip}
  • Navigate to Monitor > Nodes
  • Click on the Nodes list tab
  • A worker with the name you specified during configuration (NODE_NAME) should be displayed in the list.
  • The first three icons should be green on the worker, indicating a successful connection.

Upgrading a Pulse-IT/Automate-IT worker

  1. Copy the installation folder into the destination directory created in the installation step
  2. Unzip the worker installation folder
  3. Upgrade the worker
  • Powershell console as Administrator
  • Enter into the installer directory
cd C:\path\to\installer
  1. Run the installer script with the --upgrade option
python.exe .\setup.py --upgrade --online

Updating server information

If any information about the Pulse-IT or Automate-IT server changes (such as host address, username, or password), run the following command to update the server information:

python ./setup.py --update_server_info

The script will prompt you to enter the Pulse-IT/Automate-IT server information.

Server information can be updated in non-interactive mode using the following command:

  python.exe .\setup.py --update_server_info \
      --domain <windows-user-domain> \ 
      --username <windows-username> \ 
      --password <windows-password> \
      --server-host <pulse-it-automate-it-host-address> \
      --server-user <pulse-it-automate-it-user> \
      --server-password <pulse-it-automate-it-password> \
      --rabbitmq-host <rabbitmq-host> \
      --rabbitmq-user <rabbitmq-user> \
      --rabbitmq-password <rabbitmq-password>

Note:

  • If domain, rabbitmq-user or rabbitmq-password are empty, the corresponding option can be omitted
  • Ensure the server-host value includes the protocol, either http:// or https://

Monitor the worker

1. Event Viewer​

To check error related to the worker's services, use the Event Viewer:

  • click on the Windows start button
  • Search for "Event viewer"
  • Open Event viewer application
  • On the left side menu, click on "Windows logs" and then "Application"
  • Worker's services logs are listed with source starting with "AIT_Agent_*"

2. Worker Logs​

Worker logs can be found in C:\Automate-IT\Logs