Skip to main content
Sign Out

Welcome to Dell

My Account
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
Sign In Create an Account Dell Financial Services Premier Sign In Partner Program Sign In
Contact Us

Your Dell.com Carts

Avamar: How to to Safely Shut Down and Restart Avamar

Summary: This article describes how to safely shut down (and restart) an Avamar system for maintenance purposes.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

avoshutdown is an automated script which simplifies shutting down an Avamar system.

The Avamar should be healthy, and in a "production" state for the commands to work.
All services should be running, and there should be a recent, valid checkpoint.

 

Procedure:

There are two methods to run avoshutdown
  • Trigger the Shutdown or Reboot from the MC user interface:   

Server > Server Management > Action > Shutdown or Reboot DPN Grid
If initiated from the UI, the process runs in the background.

Or

  • Trigger the Shutdown or Reboot from the command-line interface. This allows additional options such as "precheck" and "auto restart." 
  1. Log in to a PuTTY or SSH session as user admin and switch to root user.
  2. Run the script with the required options:   

Available options when invoking the script over command line:   

  • avosshutdown help (print this help message and exit)
  • avosshutdown precheck (check if a clean Shutdown or Reboot can be performed)
  • avosshutdown shutdown (System shutdown for all data nodes and utility node)
  • avosshutdown reboot (Reboot all data nodes and utility node)
  • avosshutdown reboot autorestart (On a multinode grid, automatically restart services after Shutdown or Reboot)


Single node or Avamar Virtual Edition systems: 
Avamar services start automatically when a system is turned on. 

Note:  Running avosshutdown reboot on a single node grid with Data Domain attached results in services restarting after reboot. Run dpnctl stop before running avoshutdown reboot if you do not want this to occur.

To avoid SSH timeouts while running this commands, consider  modification of sshd_config, or run all commands in a Linux screen session.

If Garbage collection is killed by avosshutdown reboot , a checkpoint rollback will be required. Therefore, check that no maintenance task is running by reviewing the output of the status.dpn command. 

Multinode systems:
Avamar services must be started manually.

The avosshutdown process:
avosshutdown runs in the background. The script shuts down or reboots both Avamar services and the operating system. 

Information about avo shutdown


See this video:

Additional Information

Understanding the output of status.dpn
See Dell KB article 63549: Avamar - How to Understand the Output Generated by the 'status.dpn' Command.

For more information about shutting down the Avamar services:    
Consult the Avamar System Administration guide which is available on the Dell Support site.  

In the System Administration guide, locate the section which discusses the Avamar Server shutdown and restart procedure. Follow the instructions in the guide to shut down the Avamar software services.

Single Node or Avamar Virtual Edition systems:    
By default, on single node systems and Avamar Virtual Edition systems, the Avamar services start automatically when a system is turned on. On a multinode system, the Avamar services must be started manually.

Spare Nodes and NDMP accelerator nodes:    
Spare nodes and NDMP accelerator nodes must be shut down and restarted separately. To do this, log in as root and use the halt command to stop the operating system before powering off the nodes.

AER Nodes:    
AER nodes must be shut down separately using the following procedure:    
 
1. Log in to the node as admin user.
2. Stop the Avamar Server processes.
dpnctl stop
3. Stop AER
aerctl stop

Affected Products

Avamar

Products

Avamar, Data Domain
Article Properties
Article Number: 000058451
Article Type: How To
Last Modified: 05 Apr 2024
Version:  18
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.