Collecting Object Listing For A Directory
For investigation of certain situations, it could be necessary to collect a listing of objects in a directory where the backup data is stored. In this article, we describe the optimal approaches to perform such action for local and cloud directories.
- Cloud directory listing
- Local directory listing
- UNC (network-shared) directory listing
- Storage account listing using the MSP360 Backup application
Cloud directory listing
In order to collect a listing of the cloud-bound directory (or the entire bucket/container), first make sure to download a freeware MSP360 Explorer application for your cloud vendor (Amazon S3, Microsoft Azure, Google Cloud, OpenStack).
Install the application and add your storage account during the first launch, or later in the "File" tab -> "Add New Account".
Once the storage account is set up, you can see the list of its storage containers (buckets) as well as navigate inside them.
Find the required container or the directory within it that needs to be listed, right-click on it, and use the "Export object list to CSV" option:
The resulting CSV file will contain a comprehensive listing of all objects stored in the container or the directory.
Local directory listing
To collect a listing of objects stored in a local folder (on a local drive), first, open the command line interface (CMD) with administrative rights.
Use the "cd" command to navigate to the folder that needs to be listed, then use the "dir /s > list_name.txt" command to generate a listing file in the same folder:
The parameter "/s" specifies that the listing will also include all sub-folders.
After that, you can find the resulting listing file in the folder that was data-listed.
UNC (network-shared) directory listing
In order to collect a listing of objects stored in a network-shared folder, launch the command line interface (CMD) with full administrative rights.
Use the "pushd" command to map a UNC directory, the content of which needs to be listed, to a temporary network drive. Then apply the "dir /s > list_name.txt" command, as you would do for a purely local folder:
Again, the resulting listing file can then be found in the network-shared folder that was data-listed.
Once the listing data is collected, make sure to provide it where it was requested (technical support case) in order to advance the troubleshooting.
Storage account listing using the MSP360 Backup application
The MSP360 Backup software also offers a native functionality for the storage account content listing.
In order to use it, please open the elevated (administrator rights) Windows command prompt.
Use the "cd" command to navigate to the installation folder of your copy of the Backup software:
If you are an MSP, the default installation folder of the Backup software depends on your customizable company and product names, as they are specified in your MSP portal's General Settings:
C:\ProgramFiles\ MSP company name\MSP product name
If you are user of a standalone Backup software, the default installation folder of the Backup software is this:
C:\Program Files\CloudBerryLab\CloudBerry Backup
Then use the below command in order to generate a storage listing file, include it in the diagnostic log package, and automatically send that package to the MSP360 support system (a numbered support case containing the collected information will be created as a result):
cbb.exe sendLog -list "Storage Account Display Name" -u -e firstname.lastname@example.org
Command parameter details:
-list Specifies a storage account to be listed.
-u Specifies an MBS user.
This parameter should not be skipped but can be left empty as in the above example.
-e Specifies a contact email address that is to be featured in the opened support case.
This parameter can be left empty for MSPs. A support case will be opened for the MSP main administrator email address (can be checked in the MSP portal's General Settings).
Standalone Backup software users are advised to specify their contact email.
Examples of the correct usage of the storage account listing command:
- For MSPs:
- For standalone Backup software users:
Once you executed the command, check your contact email inbox and mention the reference number ("Case #") of the newly opened support case (it contains the collected information) to a support engineer working on your case.