Mate Agent Installation
On-Premises Mate Agent Installation & Port Policy Documentation
Download Links
Before proceeding with the installation, please ensure that you have reviewed the hardware and software requirements, as well as the port configurations, from the corresponding documentation section. This is essential to avoid any issues during or after installation, particularly when setting up an on-premises Mate Agent.
Introduction
The Mate Agent is a crucial component responsible for executing automation tasks in the background without the need for user intervention. This document serves as a comprehensive guide for the installation of the Mate Agent on an on-premises server, along with the necessary port configurations to ensure secure and efficient communication within the Autom Mate ecosystem.
Mate Agent Installation
STEP 1: Download the Mate Agent Setup File
Navigate to the Mate Agents menu in the "My Environment" section.
STEP 2: Run the Setup File
Run the
MateAgent.exefile as an administrator.This ensures that the installation has the necessary permissions to complete successfully.
STEP 3: Installation Wizard - Setup Choices
The installation wizard will prompt you to check your installation choices.
Review your choices and click the "Next" button to proceed.
STEP 4: Choose the Installation Directory
Determine the directory where the Mate Agent will be installed.
After selecting the directory, click the "Next" button.
STEP 5: Accept the License Agreement
Carefully read through the license agreement.
Once reviewed, accept the terms and click "Next" to proceed.
STEP 6: Application Settings Verification
Before beginning the installation, verify that the application settings are correct.
Click the "Installation" button to initiate the process.
STEP 7: Installation Progress
The installation will begin. You can click "Show Details" if you want to view the detailed progress of the installation.
STEP 8: Completing the Installation
Once the Mate Agent is installed successfully, click "Finish" to close the installation wizard.
Post-Installation Configuration
Adding Paths to Environment Variables
In some cases, the necessary paths for the Mate Agent might not be automatically added to the system’s environment variables. If they are not added, follow these steps to do so manually:
Open System Properties:
Press
Windows + R, typeSystemPropertiesAdvanced, and click OK.
Access Environment Variables:
In the Advanced tab, click the "Environment Variables" button.
Edit System Path Variable:
Under System Variables, locate the variable named
Path. Select it and click "Edit".
Add Missing Paths:
If the following paths are not already added, add them one by one by clicking "New":
C:\mateagent\opencv\buildC:\mateagent\opencv\build\binC:\mateagent\Tesseract-OCRC:\Program Files\nodejs(if it is not added automatically)
Click OK to save the changes.
Adding Log On Credentials to MAGateway Service
To activate the use of the Desktop Actions library, the MAGateway service requires an administrator user with Task Scheduler authority. If the default admin user lacks this authority, follow these steps:
Open Services:
Press
Windows + R, typeservices.msc, and click OK.
Locate and Configure MAGateway:
Find
MAGatewayin the list of services, right-click it, and select "Properties".
Log On Configuration:
In the Log On tab, enter the credentials for the admin user.
Click "Apply" and then "OK".
We strongly recommend performing the installation of both the Autom Center and Mate Agent on a fresh server to avoid potential conflicts with existing software and ensure optimal performance.
Port Policy for Communication
The port policy for Autom Mate ensures secure and efficient communication between the Mate Agent, Autom Mate Cloud, and other system components. Adhering to this policy is critical for the smooth operation of the system.
Agent Server Port Configuration
Below is a list of ports used for communication and various services:
5051 (TCP):
Agent: Inbound traffic allowed.
Autom Center: Outbound traffic allowed.
443 (TCP) and 80 (TCP):
Agent: Outbound traffic allowed.
Autom Center: Inbound traffic allowed.
Note: Outbound traffic is restricted on the server hosting the Mate Agent, except for ports 80, 443, and 5051.
Importance of Port Policy
Implementing a well-defined port policy is essential for maintaining the security and efficiency of the Autom Mate system. By configuring the necessary ports for inbound and outbound traffic, you enable seamless communication between the Mate Agent, Autom Mate Cloud, and other system components, thereby enhancing the overall performance and security of the system.
Last updated
