Skip to main content
BlueXP copy and sync

Manage data broker groups

Contributors netapp-bcammett netapp-ivanad

A data broker group syncs data from a source location to a target location. At least one data broker is required in a group for each sync relationship that you create. Manage data broker groups by adding a new data broker to a group, by viewing information about groups, and more.

How data broker groups work

A data broker group can include one or more data brokers. Grouping data brokers together can help improve the performance of sync relationships.

Groups can manage several relationships

A data broker group can manage one or more sync relationships at a time.

For example, let's say you have three relationships:

  • Relationship 1 is managed by data broker group A

  • Relationship 2 is managed by data broker group B

  • Relationship 3 is managed by data broker group A

You want to accelerate the performance of relationship 1 so you add a new data broker to data broker group A. Because group A also manages sync relationship 3, the sync performance for relationship is automatically accelerated as well.

Number of data brokers in a group

In many cases, a single data broker can meet the performance requirements for a sync relationship. If it doesn't, you can accelerate sync performance by adding additional data brokers to the group. But you should first check other factors that can impact sync performance. Learn more about how to determine when multiple data brokers are required.

Security recommendations

To ensure the security of your data broker machine, NetApp recommends the following:

  • SSH should not permit X11 Forwarding

  • SSH should not permit TCP connection forwarding

  • SSH should not permit tunnels

  • SSH should not accept client environment variables

These security recommendations can help prevent unauthorized connections to the data broker machine.

Add a new data broker to a group

There are several ways to create a new data broker:

Before you get started
  • You can't add data brokers to a group that manages an encrypted sync relationship.

  • If you want to create a data broker in an existing group, the data broker must be an on-prem data broker or the same type of data broker.

    For example, if a group includes an AWS data broker, then you can create an AWS data broker or on-prem data broker in that group. You can't create an Azure data broker or Google Cloud data broker because they aren't the same data broker type.

Steps to create a data broker in a new group
  1. Select Sync > Manage Data Brokers.

  2. Select Add New Data Broker.

  3. Follow the prompts to create the data broker.

    For help, refer to the following pages:

Steps to create a data broker in an existing group
  1. Select Sync > Manage Data Brokers.

  2. Select the action menu and select Add Data Broker.

    A screenshot of the action menu that's available for each individual data broker in a group.

  3. Follow the prompts to create the data broker in the group.

    For help, refer to the following pages:

Edit a group's name

Change the name of a data broker group at any time.

Steps
  1. Select Sync > Manage Data Brokers.

  2. Select the action menu and select Edit Group Name.

    A screenshot of the action menu that's available for each individual data broker in a group.

  3. Enter a new name and select Save.

Result

BlueXP copy and sync updates the name of the data broker group.

Set up a unified configuration

If a sync relationship encounters errors during the sync process, unifying the concurrency of the data broker group can help to decrease the number of sync errors. Be aware that changes to the group's configuration can affect performance by slowing down the transfer.

We don't recommend changing the configuration on your own. You should consult with NetApp to understand when to change the configuration and how to change it.

Steps
  1. Select Manage Data Brokers.

  2. Select the Settings icon for a data broker group.

    A screenshot that shows the Settings icon for a data broker group.

  3. Change the settings as needed and then select Unify Configuration.

    Note the following:

    • You can pick and choose which settings to change—​you don't need to change all four at once.

    • After a new configuration is sent to a data broker, the data broker automatically restarts and uses the new configuration.

    • It can take up to a minute until this change takes place and is visible in the BlueXP copy and sync interface.

    • If a data broker isn't running, it's configuration won't change because BlueXP copy and sync can't communicate with it. The configuration will change after the data broker restarts.

    • After you set a unified configuration, any new data brokers will automatically use the new configuration.

Move data brokers between groups

Move a data broker from one group to another group if you need to accelerate the performance of the target data broker group.

For example, if a data broker is no longer managing a sync relationship, you can easily move it to another group that is managing sync relationships.

Limitations
  • If a data broker group is managing a sync relationship and there's only one data broker in the group, then you can't move that data broker to another group.

  • You can't move a data broker to or from a group that manages encrypted sync relationships.

  • You can't move a data broker that is currently being deployed.

Steps
  1. Select Sync > Manage Data Brokers.

  2. Select A screenshot of the button that enables you to expand the list of data brokers in a group. to expand the list of data brokers in a group.

  3. Select the action menu for a data broker and select Move Data Broker.

    A screenshot of the action menu that's available for each individual data broker group.

  4. Create a new data broker group or select an existing data broker group.

  5. Select Move.

Result

BlueXP copy and sync moves the data broker to a new or existing data broker group. If there are no other data brokers in the previous group, then BlueXP copy and sync deletes it.

Update proxy configuration

Update the proxy configuration for a data broker by adding details about a new proxy configuration or by editing the existing proxy configuration.

Steps
  1. Select Sync > Manage Data Brokers.

  2. Select A screenshot of the button that enables you to expand the list of data brokers in a group. to expand the list of data brokers in a group.

  3. Select the action menu for a data broker and select Edit Proxy Configuration.

  4. Specify details about the proxy: host name, port number, user name, and password.

  5. Select Update.

Result

BlueXP copy and sync updates the data broker to use the proxy configuration for internet access.

View a data broker's configuration

You might want to view details about a data broker to identify things like its host name, IP address, available CPU and RAM, and more.

BlueXP copy and sync provides the following details about a data broker:

  • Basic information: Instance ID, host name, etc.

  • Network: Region, network, subnet, private IP, etc.

  • Software: Linux distribution, data broker version, etc.

  • Hardware: CPU and RAM

  • Configuration: Details about the data broker's two kinds of main processes—​scanner and transferrer

    Tip The scanner scans the source and target and decides what should be copied. The transferrer does the actual copying. NetApp personnel might use these configuration details to suggest actions that can optimize performance.
Steps
  1. Select Sync > Manage Data Brokers.

  2. Select A screenshot of the button that enables you to expand the list of data brokers in a group. to expand the list of data brokers in a group.

  3. Select A screenshot of the button that enables you to expand details about a data broker. to view details about a data broker.

    A screenshot of information about a data broker.

Address issues with a data broker

BlueXP copy and sync displays a status for each data broker that can help you troubleshoot issues.

Steps
  1. Identify any data brokers that have a status of "Unknown" or "Failed."

    A screenshot of the BlueXP copy and sync status display where a data broker has an "unknown" status.

  2. Hover over the An "info" icon. icon to see the failure reason.

  3. Correct the issue.

    For example, you might need to simply restart the data broker if it's offline, or you might need to remove data broker if the initial deployment failed.

Remove a data broker from a group

You might remove a data broker from a group if it's no longer needed or if the initial deployment failed. This action only deletes the data broker from BlueXP copy and sync's records. You'll need to manually delete the data broker and any additional cloud resources yourself.

Things you should know
  • BlueXP copy and sync deletes a group when you remove the last data broker from the group.

  • You can't remove the last data broker from a group if there is a relationship using that group.

Steps
  1. Select Sync > Manage Data Brokers.

  2. Select A screenshot of the button that enables you to expand the list of data brokers in a group. to expand the list of data brokers in a group.

  3. Select the action menu for a data broker and select Remove Data Broker.

    A screenshot of the action menu that's available for each individual data broker group.

  4. Select Remove Data Broker.

Result

BlueXP copy and sync removes the data broker from the group.

Delete a data broker group

If a data broker group no longer manages any sync relationships, you can delete the group, which removes all of the data brokers from BlueXP copy and sync.

Data brokers that BlueXP copy and sync removes are only deleted from BlueXP copy and sync's records. You'll need to manually delete the data broker instance from your cloud provider and any additional cloud resources.

Steps
  1. Select Sync > Manage Data Brokers.

  2. Select the action menu and select Delete Group.

    A screenshot of the action menu that's available for each individual data broker in a group.

  3. To confirm, enter the name of the group and select Delete Group.

Result

BlueXP copy and sync removes the data brokers and deletes the group.