vRanger 7.6.6 - Integration Guide for EMC Data Domain Boost (DD Boost)

Modifying an interface group

Modifying an interface group

After the interface group is set up, you can add or delete interfaces from the group. The following example shows how to remove an interface from the configured interface group on the EMC® Data Domain® system.

Make sure that no jobs are active from vRanger to the Data Domain system on the interface that you want to remove from the group. You can complete this step from the Data Domain system by checking the status of existing connections in the interface group by entering the following command:

# ddboost show connections

Sample Output:

Client Connections:

Max Client Connections: 149

ifgroup status: Enabled

Interface ifgroup ------------- Connections ------------

member Backup Restore Control * Total

---------------- ------ ------ ------- ------- ------

192.168.54.138 yes 15 0 2 17

192.168.52.192 yes 15 0 3 18

192.168.55.206 yes 16 0 3 19

---------------- ------ ------ ------- ------- ------

Total Connections 46 0 8 54

* Control connections for file-replication, file operations

Remove the interface from the group on Data Domain system:

# ddboost ifgroup del default interface 192.168.1.3

After this step, the interface 192.168.1.3 is released from the group and is no longer used by the DD Boost Storage Server for any jobs from the backup servers.

 

NOTE: Removing the interface registered with vRanger makes the Data Domain system inaccessible to the backup servers. The configuration of the ifgroup on the Data Domain system is not deleted.

To change the interface that is added to the interface group on the Data Domain system at the network layer, remove the interface from the group and add it back.

If you use the net command to change the interface, such as enabling an interface that is configured for ifgroup, run the ddboost show connections command to update the load balancing view. This updating allows the ifgroup to use the interface. For more information about the ddboost show connections command, see Show connections.

Removing advanced load balancing and link failover configuration

Removing advanced load balancing and link failover configuration

The following example illustrates removing a configured interface group on the EMC® Data Domain® system.

1	Make sure that no jobs are active from vRanger to the Data Domain system.

You can complete this step from the Data Domain system by checking the status of existing connections in the interface group with the following command:

# ddboost ifgroup show connections

2	Ensure that there are no pending jobs from any of the connected backup servers to this system.

3	Disable the feature on the Data Domain system:

# ddboost ifgroup disable

4	Reset the interface group:

# ddboost ifgroup reset

All the interfaces are released from the group. However, backup servers can still access the DD Boost storage server on the Data Domain system on the interface registered with vRanger. In the preceding example, the Data Domain system is still registered with vRanger using 192.168.1.1.

Setting network timeouts

Setting network timeouts

Backup and restore jobs often take a long time to complete. Although the EMC® Data Domain® Boost (DD Boost™) Library can recover from temporary network interruptions, the operating system on vRanger might terminate a job prematurely if vRanger timeouts are set too low.

EMC recommends setting timeouts to at least 30 minutes (1800 seconds).

 

NOTE: After losing a network connection, administrators should issue the ddboost reset stats command to clear job connections.

Using the DD Boost commands

Using the DD Boost commands

This topic describes the EMC® Data Domain® Boost (DD Boost™) commands that you use to manage the DD Boost feature on the EMC® Data Domain® system.

 

NOTE: For information about configuring DD Boost using the graphical user interface (GUI)-based Enterprise Manager, see the EMC Data Domain Operating System Administration Guide.

The ddboost command manages the integration of Data Domain systems and disk backup devices. DD Boost is a licensed feature. If basic options do not work, verify that the proper licensing has been implemented on your Data Domain system. The ddboost command includes the following options.

Access

 

Table 1.  

Description	Manage DD Boost access for clients.
Syntax	• ddboost access add clients: Add clients to a DD Boost access list. ddboost access add clients client-list • ddboost access delete clients: Delete clients from DD Boost access list. ddboost access del clients client-list • ddboost access reset: Reset DD Boost client access list to factory default. ddboost access reset • ddboost access show: Show DD Boost client access list. ddboost access show

Destroy

 

Description	Administrators use this command to delete all storage units and their contents from the Data Domain system. The command permanently removes all the data (files) contained in the storage units. You must also manually remove (expire) the corresponding catalog entries.
Syntax	ddboost destroy

Disable

 

Description	Administrators use this command to disable DD Boost for the Data Domain system.
Syntax	ddboost disable

Enable

 

Description	Administrators use this command to enable DD Boost for the Data Domain system. Whenever the user, user ID (UID), or group ID (GID) changes, the Data Domain system updates all files and storage units the next time that the ddboost enable command is issued.
Syntax	ddboost enable

Ifgroup add interface

 

Description

Administrators use this command to add an IP address to a private network that is to process data transfer. The IP address must be configured on the Data Domain system, and its interface enabled. The command checks if the IP address is valid. If not, a message reports the IP address is invalid — either because it is not configured on the Data Domain system, or its interface is not enabled. Use the net show settings or net show config commands to view available IP addresses. If the IP is valid, the message IP added to list is displayed. After adding an IP address as an interface, you need to enable Advanced Load Balancing and Link Failover using the ddboost ifgroup enable command. Notes: • If an interface — or a network interface card (NIC) that has multiple interfaces — fails, all the in-flight jobs to that interface transparently fail over to a healthy interface in the ifgroup. Any jobs that are started after the failure are routed to the healthy interfaces. You can add public or private IP addresses for data transfer connections. • Quest does not recommend that you use 1 GbE and 10 Give connections in the same interface group. • You can add public or private IP addresses for data transfer connections.

Syntax

ddboost ifgroup add interface <IP address>

Ifgroup del interface

 

Description	Administrators use this command to remove a valid IP address added as an interface. If you are attempting to delete the last IP address interface, you are informed that doing so disables the ifgroup, and you are given the option of terminating this command.
Syntax	ddboost ifgroup del interface <IP address>

Ifgroup disable

 

Description	Administrators use this command to disable the Advanced Load Balancing and Link Failover option for new jobs. Currently running jobs are not affected and continue to run. If DD Boost is disabled, the message disabled is displayed.
Syntax	ddboost ifgroup disable

Ifgroup enable

 

Description	Administrators use this command to enable Advanced Load Balancing and Link Failover. At least one IP address must have already been added.
Syntax	ddboost ifgroup enable

Ifgroup reset

 

Description	Administrators use this command to remove the interfaces for Advanced Load Balancing and Link Failover and to disable the ifgroup. The ifgroup reset command is equivalent to issuing the ddboost ifgroup disable command followed by issuing multiple ddboost ifgroup del interface <IP address> commands.
Syntax	ddboost ifgroup reset

Ifgroup show config

 

Description	Display IP addresses added to the interface group.
Syntax	ddboost ifgroup show config

Option reset

 

Description	Administrators use this command to reset distributed segment processing to the default, which is enabled.
Syntax	ddboost option reset distributed-segment processing

Option set

 

Description

Administrators can use this command to enable or disable the distributed segment processing feature on the Data Domain operating system. By default, it is enabled. If this feature presents any problem for a backup server, use this command to disable the feature on the Data Domain system. Distributed segment processing is supported only if the installed version of the DD Boost Library is version 2.2 or later, and the feature is enabled on the Data Domain operating system. Notes: • Distributed segment processing is enabled by default. • If a system is upgraded from Data Domain OS 4.9 to Data Domain OS 5.0 and the DD Boost option was disabled before the upgrade, the distributed-segment-processing option is disabled after the upgrade.

Syntax

ddboost option set distributed-segment-processing {enabled | disabled}

Option show

 

Description	Use this command to show whether the distributed segment processing option is enabled or disabled.
Syntax	ddboost option show distributed-segment-processing

Reset stats

 

Description	Administrators use this command as follows: • To reset all statistics when DD Boost is enabled, or • As a network recovery procedure to clear job connections after the network connection has been lost.
Syntax	ddboost reset stats

Reset user-name

 

Description	Delete and reset the DD Boost user name.
Syntax	ddboost reset user-name

Set user-name

 

Description	Set the DD Boost user name when DD Boost is enabled.
Syntax	ddboost set user-name <user-name>

Show connections

 

Description

Use this command to show the number of active clients, and for each active client: • The client’s name. • Whether the client is idle (yes/no). • The number of installed CPUs. • The amount of memory in MiB. • The installed Library version number. • The name and version of the operating system. • vRanger version number. • The number of connections that a system uses for DD Boost, and whether these connections are spread across interfaces using Advanced Load Balancing and Link Failover. • The number of connections used for a given group, even when the interface has been removed from the ifgroup. • An overview of interfaces available for DD Boost.

Syntax

ddboost show connections

Show histogram

 

Description

Use this command to display a DD Boost histogram for the Data Domain system. • op: The name of the NFS operation. • mean-ms: The mathematical mean time for completion of the operations. • stddev: The standard deviation for time to complete operations, derived from the mean time. • max-s: The maximum time taken for a single operation. • 2,4,6,8, or 10ms: The number of operations that took less than the specified number of milliseconds (ms). • 100ms: The number of operations that took between 10 ms and 100 ms. • 1s: The number of operations that took between 100 ms and one second. • 10s: The number of operations that took between 1 second and 10 seconds. • >10s: The number of operations that took over 10 seconds.

Syntax

ddboost show connections

Show stats

 

Description

Use this command to show the output of previous show stats command, the number of bytes written to and read from files contained in storage units, and the number of files created and deleted from storage units. The number of errors encountered for each operation is also shown. Optionally, you can show statistics for a specific number of seconds. The count displays the number of lines equal to the count value. If distributed segment processing is enabled, the number of bytes transferred through distributed segment processing and the amount of compression achieved is displayed.

Syntax

ddboost show stats [interval seconds] [count count]

Show user-name

 

Description	Display the current DD Boost user.
Syntax	ddboost show user-name

Status

 

Description	Enter this command to determine whether DD Boost is enabled or disabled.
Syntax	ddboost status

Storage-unit create

 

Description	Administrators use this command to create a storage unit with a given name.
Syntax	ddboost storage-unit create storage-unit-<name>

Storage-unit delete

 

Description	Administrators use this command to delete a specified storage unit and all its contents. You must also manually remove (expire) the corresponding catalog entries.
Syntax	ddboost storage-unit delete storage-unit-<name>

Storage-unit show

 

Description	Use this command to display the names of all storage units or, optionally, the names of all files in a specified storage unit. To display the compression for all storage units (the original byte size, global compression, and local compression for all storage units), enter the compression option. NOTE: To interrupt the output of this command, press Ctrl+C.
Syntax	ddboost storage-unit show [compression] [storage-unit-name]