> For the complete documentation index, see [llms.txt](https://docs.zmanda.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zmanda.com/documentation/common-questions.md).

# Common Questions

### My backup seems to be very slow​ <a href="#my-backup-seems-to-be-very-slow" id="my-backup-seems-to-be-very-slow"></a>

**Explanation:** Zmanda Pro is configured so that all significant operations are handled by the client’s device. If the device is limited in terms of CPU power, memory, network infrastructure, or internet connection speed, this can impede the backup process.

**Solutions:**

1. **Diagnose Hardware and Network Issues:** Assess and rectify any problems with the device or network that might be slowing down the backup.
2. **Evaluate System Load:** Verify that no other intensive processes are running simultaneously that might affect the backup operation.​

### Challenges with Network Share Backups <a href="#challenges-with-network-share-backups" id="challenges-with-network-share-backups"></a>

**Problem:** Network shares are accessible, but backups fail.

**Solutions:**

1. **Path Verification:** Make sure network paths are specified using a UNC path rather than a local drive letter that may not be universally recognized.
2. **Permission Configuration:** Check that the backup client has the necessary permissions to access the share. Consider setting up a specific user account for the backup client.
3. **Client Installation Strategy:** Install the backup client directly on the device storing the original data for more effective access.

### Excessive Data Download during Small File Restoration​ <a href="#excessive-data-download-during-small-file-restoration" id="excessive-data-download-during-small-file-restoration"></a>

**Explanation:** The restoration process involves an index that identifies which data chunks are needed. Even though this index is typically small, it can become significantly large in extensive data stores.

### Windows Server System State Backup Issues​ <a href="#windows-server-system-state-backup-issues" id="windows-server-system-state-backup-issues"></a>

* **Solutions:**
  1. **Avoid Spooling to Backup Targets:** Do not spool data to drives that are also being backed up.
  2. **Utilize Permanent Storage Solutions:** Avoid using ephemeral storage devices like removable USB drives for critical backups.
  3. **Switch Backup Methods:** If persistent issues arise, consider adopting the Zmanda Pro Disk Image backup method designed to handle such complexities: [Disk Image Walkthrough | Zmanda Documentation](https://docs.zmanda.com/guide/protected-items/disk-image)

### Volume Shadow Copy Service (VSS) Troubleshooting <a href="#volume-shadow-copy-service-vss-troubleshooting" id="volume-shadow-copy-service-vss-troubleshooting"></a>

**Introduction to VSS:** Volume Shadow Copy Service (VSS) is an essential Microsoft technology designed to create consistent, point-in-time backups of disk volumes. It utilizes VSS Writers, which are software components that monitor the snapshot process to ensure files are in a stable state for backup. This system is crucial for backing up application-specific data efficiently.

**VSS Limitations and Issues:**

* **Network Limitations:** VSS cannot operate over network paths. It requires the backup client to be installed on the device containing the original data.
* **Interference from Other Software:** Other active backup software can disrupt VSS operations. Disabling conflicting software might resolve these issues.
* **Diagnostic Error Codes:** Error codes such as 0xXXXXXXXX can indicate the reasons behind VSS failures. Investigating these codes is critical for resolving VSS issues.

**Detailed VSS Diagnostic Steps**

**Checking VSS Writers:**

1. Open a command prompt with administrative rights.
2. Execute the command `vssadmin list writers` to review the status of each VSS Writer, noting any that report errors.

**Advanced VSS Diagnostics with VSSTrace:** For deeper insights into VSS operations:

1. Download and extract VSSTrace.
2. Open an elevated command prompt, navigate to the VSSTrace directory.
3. Execute `.\vsstrace.exe -l 255 +f 0xffff > trace001.log`.
4. Run the backup operation.
5. Upon failure, stop the trace and review `trace001.log` for detailed diagnostics.

### Job History Management <a href="#job-history-management" id="job-history-management"></a>

**Persistent 'Running' Jobs: If a job remains in the 'running' state:**

1. **Allow Natural Completion:** Initially, let the job complete on its own.
2. **Forced Software Update:** If persistence continues, force a software update via Connected Devices -> Actions to terminate the job.
3. **Reindex Storage Vault:** Post-update, enable advanced options, and reindex the vault to reset job statuses and organize data.

#### Detailed Error Logs Troubleshooting <a href="#detailed-error-logs-troubleshooting" id="detailed-error-logs-troubleshooting"></a>

#### "Reindex Needed" Alerts <a href="#reindex-needed-alerts" id="reindex-needed-alerts"></a>

**Scenario:** Logs indicate discrepancies between indexed and actual stored data chunks.

**Solution:**

Logs indicating a mismatch between index files and actual data stored can be addressed by:

1. Navigating to Admin -> Advanced Options.
2. Selecting the affected user, accessing the Devices tab, and choosing Reindex under Storage Vault options.
3. Applying retention rules and verifying corrections in the job history.

#### Snapshot Dependency Errors <a href="#snapshot-dependency-errors" id="snapshot-dependency-errors"></a>

Error logs such as "\<packindex/xxxxxxxx> says \<snapshot/yyyyyyyy> depends on missing pack \<data/zzzzzzzz>":

**Problem:** Logs show that certain snapshots depend on missing data packs, rendering them non-restorable.

**Solution:**

1. Locate and document the affected data bucket using the Storage Vaults tab under the user’s profile.
2. Access the storage location, identify, and delete the specified 'packindex' files causing the issue.
3. Reapply retention rules and verify through logs that the missing data chunks have been indexed or that the corrupted snapshot has been purged.

#### Handling Locked Storage Vaults <a href="#handling-locked-storage-vaults" id="handling-locked-storage-vaults"></a>

"Cannot Proceed - Locked by Device"

**Issue Identification:** Occasionally, a storage vault may be locked by a device, preventing any new write operations.

**Unlocking Procedure:**

1. Identify the locking device via user profiles and device IDs.
2. Ensure no active jobs are using the vault.
3. Access admin settings to unlock the vault and finalize any pending backup operations.

### Installation and Configuration Issues <a href="#installation-and-configuration-issues" id="installation-and-configuration-issues"></a>

**Solutions:**

* **Ensure Full Extraction:** Before installation, make sure the installer files are fully extracted.
* **Adjust Anti-virus Settings:** Set antivirus software to ignore the installation files, which can prevent interruption of the installation process.

### Connectivity and User Interface Issues​ <a href="#connectivity-and-user-interface-issues" id="connectivity-and-user-interface-issues"></a>

**Solutions:**

* **Reinstallation of Client Software:** A fresh installation can reset configurations and resolve underlying issues.
* **Software Updates:** Regularly update the client software through the admin panel to ensure all devices run the latest version, potentially resolving compatibility or performance issues.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zmanda.com/documentation/common-questions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
