WHM Tutorials - File and Directory Restoration
Howdy! This is Rosie Arcelay, a
technical writer for cPanel, the hosting platform of choice. Today, I will show you
the File and Directory Restoration interface for cPanel & WHM version 76.
You can use this interface in WHM or in cPanel to restore files and directories
from local backups. Restoring a single file or a directory is faster and easier
than restoring a big backup file. We introduced the File and Directory
restoration interface in cPanel & WHM version 72. For version 76, we updated the
interface's appearance. This video will focus on the File and Directory
Restoration interface in WHM. If you'd like to see how file and directory
restoration works in the cPanel interface, check out our version 76
tutorial. I've added a card and the link to the video in the description. This
interface works with metadata. To use the interface, the system must generate
metadata when it runs a backup. For your system to run a backup, you must enable
this functionality in the Backup Configuration interface in WHM. If you want to learn more about how
backups metadata works, read cPanel's How to Manage Metadata Settings document.
I included the link in the description below. Now, I'm going to log in to WHM to
show you its File and Directory Restoration interface. Log in to WHM.
Find the File and Directory Restoration interface. You can search for it in the
search bar, or find it under the "Backup" section in the left menu. Then click "File
and Directory Restoration", in the left menu, to access the interface. The
accounts list will appear. Select the account that contains the items that
you'd like to restore from the account list. I will select the example user for
the example.com website. Then click the "View Backups" button, located below the
account list. With this action, a new interface appears. With this interface, I
can retrieve the backups available for the example account. This interface
contains two sections: the Files and Directories section shows the files and
directories that contain backups. To list the backups, click "Show Backups" in the
File and Directories section. The backups will appear in the Backups section. Uou
can return to the account list if you selected a different account than the
one you wanted. (Ugh! I hate it when I do that! Don't you?)
From this interface, you can access this account's backups in two ways. I will show
you both. You can enter a direct path to the file
or directory, or you can browse through files and directories until you find the
file that you wish to restore from a backup. Let's start with retrieving
backups through a direct path. "Enter a path" is the default setting, so you'll
see a text box where you can enter a direct path. Your home directory already
appears in the interface. Enter the path under this directory to find your
backups. Since I want to retrieve the backups for the document root, I'll
enter public_hmtl in the text box. Click "Show Backups" to... show me the
backups! The backups now appear under the Backups section. This section tells me the
directory's name. In this case, it's public_hmtl. The interface
shows whether the directory exists on the local disk. This information is
important. If the answer is yes, this lets me know that I'm going to
overwrite the directory when I restore the backup. If the answer is no, then the
directory does not exist on the local disk. I know that I'm going to completely
restore the directory to the disk. That's information I need to know in case my
cPanel user lost all of the directory's contents. I can help them make the
contents reappear. I know that this directory exists on the local disk, but I
am going to restore the public_hmtl directory from one of
these backups. I am going to select the most recent backup from this list. So, I
will click Restore then click the blue Restore button, in the panel that appears,
to confirm. There's my confirmation message, so I know that the system was
able to restore it. Now, let's do this again, but let's browse to find the
directory this time. Select "Browse files and directories".
This action will show you the content of your home directory, that the system has
backed up, to restore the entire public_hmtl directory. I would find
its name on the list and click "Show Backups". This action would show all the
backups for this directory. I would repeat the same actions that I showed
you before to restore it. However, this time, I want to restore one file inside
the public_hmtl directory. The file that I want to restore is called
test_backup.txt to find this file. I will return to the home
directory. To do so, I will click Home above the list. The interface will direct
me back to display the contents of the Home directory. I'm going to find the
public_hmtl directory on the list and click on its name. This action
shows me the contents of that directory. I will look at the directory's contents
and, there, I see the file that I want: the test_backup.txt file. I will
click "Show Backups" to list the file's backups. The backups will appear under
the Backup section. I am going to select the most recent backup from this list.
Notice that this file is not on the local disk. When I click Restore the
confirmation will ask me whether I want to add the file to the local disk. I want
to restore that file to the local disk, so I will click the blue Restore button.
The confirmation message tells me that the restoration was successful. And,
you're done! You have successfully restored a file or directory from a
backup. For more information about cPanel, visit
cPanel.com or follow us on twitter at cPanel. Thanks for watching! Show me the backups!