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

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]

 

About us

We are more than just a name

We are on a quest to make your information technology work harder for you. That is why we build community-driven software solutions that help you spend less time on IT administration and more time on business innovation. We help you modernize your data center, get you to the cloud quicker and provide the expertise, security and accessibility you need to grow your data-driven business. Combined with Quest’s invitation to the global community to be a part of its innovation, and our firm commitment to ensuring customer satisfaction, we continue to deliver solutions that have a real impact on our customers today and leave a legacy we are proud of. We are challenging the status quo by transforming into a new software company. And as your partner, we work tirelessly to make sure your information technology is designed for you and by you. This is our mission, and we are in this together. Welcome to a new Quest. You are invited to Join the Innovation™.

We are more than just a name

About us

We are on a quest to make your information technology work harder for you. That is why we build community-driven software solutions that help you spend less time on IT administration and more time on business innovation. We help you modernize your data center, get you to the cloud quicker and provide the expertise, security and accessibility you need to grow your data-driven business. Combined with Quest’s invitation to the global community to be a part of its innovation, and our firm commitment to ensuring customer satisfaction, we continue to deliver solutions that have a real impact on our customers today and leave a legacy we are proud of. We are challenging the status quo by transforming into a new software company. And as your partner, we work tirelessly to make sure your information technology is designed for you and by you. This is our mission, and we are in this together. Welcome to a new Quest. You are invited to Join the Innovation™.