#1 Global Leader in Data Resilience

How to Set Custom Deployer and Data Mover Ports for Managed Linux Agents

KB ID: 4519
Product: Veeam Backup & Replication | 12
Veeam Agent for Linux | 6.0
Published: 2023-12-05
Last Modified: 2023-12-05
mailbox
Get weekly article updates
By subscribing, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.

Cheers for trusting us with the spot in your mailbox!

Now you’re less likely to miss what’s been brewing in our knowledge base with this weekly digest

error icon

Oops! Something went wrong.

Please, try again later.

Veeam Backup & Replication 12.1 Feature
The functionality documented in this article is new in Veeam Backup & Replication 12.1. (12.1.0.2131)

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:
Get-VBRProtectionGroup | ft Name,Description,ID
  • To get the ID for a specific Protection Group by name:
Get-VBRProtectionGroup -Name 'Protection Group'
Port Assignment Logic

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-Specifc 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>

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>

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

This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please, try again later.

You have selected too large block!

Please try select less.

KB Feedback/Suggestion

This form is only for KB Feedback/Suggestions, if you need help with the software open a support case

By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.
This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.
Verify your email to continue your product download
We've sent a verification code to:
  • Incorrect verification code. Please try again.
An email with a verification code was just sent to
Didn't receive the code? Click to resend in sec
Didn't receive the code? Click to resend
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please, try again later.