How to Set Custom Deployer and Data Mover Ports for Managed Linux Agents
Purpose
By default, during the deployment of Veeam Agent for Linux on a Linux machine by Veeam Backup & Replication, the services listed below use the default ports indicated. This article documents how to change those default ports using registry settings on the Veeam Backup Server.
- Veeam Deployer Service (veeamdeployment) - Default Port: 6160
- Veeam Transport Service (veeamtransport) - Default Port: 6162
Solution
Before You Begin
- The custom port will only be assigned to Veeam Agent for Linux deployments that occur after the creation of the registry value.
- There is no failover to the default port if communication fails using the custom port; ensure firewalls are configured accordingly.
- To get the ID# of a Protection Group, use one of the following PowerShell commands:
- To get a list of all Protection Groups and their IDs:
- To get the ID for a specific Protection Group by name:
When a Protection Group begins the process of deploying Veeam Agent for Linux on a Linux machine, it uses the following logic priority to determine which ports should be used by the Deployment Service and Transport Service on that machine:
- Use the custom port specified in the Protection Group-specific registry value if the Protection Group's ID is listed in that registry value.
- Use the custom global port if one is configured in the registry.
- Use the default port.
Veeam Deployer Service (veeamdeployment)
These settings change which port the Veeam Deployer Service binds to.
Protection Group-Specific Custom Deployer Service Port
Configuring this registry value will cause all new Veeam Agent for Linux deployments for the specified Protection Group(s) (specified by ID#) to use the assigned port.
Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: AMProtectionGroupCustomDeployerPort
Value Type: Multi-String Value [REG_MULTI_SZ]
Value Data: PG_ID:port
Each line should have PG_ID:port format. For example:
5b065724-eca0-4145-ba18-febcd4767ba1:6164 5d7604ff-92f9-41ee-9f8b-cc9359f0217f:7174
Global (All Protection Groups) Custom Deployer Service Port
Configuring this registry value will cause all new Veeam Agent for Linux deployments managed by Veeam Backup & Replication to use the assigned port.
Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: AMCustomLinuxDeployerPort
Value Type: DWORD (32-Bit) Value [REG_DWORD]
Value Data: <port_number>
Please note that the custom Veeam Deployment Service port configured via the registry will not impact scenarios involving the deployment of Veeam Agent for Linux using the pre-installed Veeam Deployer Service. To configure a custom port for the pre-installed Veeam Deployer Service, the following command must be executed after the standard set of pre-installed deployer commands has been completed, and the service must then be restarted:
/opt/veeam/deployment/veeamdeploymentsvc --set-port XXXX
Veeam Transport Service (veeamtransport)
These settings change which port the Veeam Transport Service binds to.
Protection Group-Specifc Custom Transport Service Port
Configuring this registry value will cause all new Veeam Agent for Linux deployments for the specified Protection Group(s) (specified by ID#) to use the assigned port for the Veeam Transport Service.
Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: AMProtectionGroupCustomDataMoverPort
Value Type: Multi-String Value [REG_MULTI_SZ]
Value Data: PG_ID:port
Each line should have PG_ID:port format. For example:
5b065724-eca0-4145-ba18-febcd4767ba1:6164 5d7604ff-92f9-41ee-9f8b-cc9359f0217f:7174
Global (All Protection Groups) Custom Transport Service Port
Configuring this registry value will cause all new Veeam Agent for Linux deployments managed by Veeam Backup & Replication to use the assigned port the Veeam Transport Service.
Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: AMCustomDataMoverPort
Value Type: DWORD (32-Bit) Value [REG_DWORD]
Value Data: <port_number>
If this KB article did not resolve your issue or you need further assistance with Veeam software, please create a Veeam Support Case.
To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.
Spelling error in text
Thank you!
Your feedback has been received and will be reviewed.
KB Feedback/Suggestion
This form is only for KB Feedback/Suggestions, if you need help with the software open a support case
Thank you!
Your feedback has been received and will be reviewed.
Oops! Something went wrong.
Please, try again later.