Backup Troubleshooting: Unterschied zwischen den Versionen

Aus TERRA CLOUD WIKI
Wechseln zu: Navigation, Suche
K (Erneut registrieren)
 
(deactivate CBT (Changed Block Tracking))
 
(838 dazwischenliegende Versionen von 7 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
== VSS-Troubleshooting Guide ==
+
== '''VSS Troubleshooting Guide''' ==
'''Fehler:''' <br>
+
'''Error pattern:''' <br>
Das Backup wird abgebrochen oder wird mit Fehlern abgeschlossen. In den Logs werden VSS-Fehler/Errors angezeigt (VSS -E-05408, VSS -E-05591, o.Ä.)
+
The backup is aborted or is completed with errors. VSS errors/errors are displayed in the logs (e.g.: VSS -E-05408, VSS -E-05591). <br>
 +
VSS errors can take many different forms.
  
'''Ursache''' <br>
+
'''Possible causes:''' <br>
Die VSS-Provider werden von einem anderem Prozess genutzt (weitere Backup-Software, weitere Backup Jobs). Die VSS-Provider sind nicht vollständig vorhanden oder defekt.
+
The VSS providers are used by another process (other backup software, other backup jobs). The VSS providers are not fully present or are defective.
Der Agent benötigt funktionsfähige VSS-Provider. Wir setzen dabei zu 100% auf Microsoft VSS - unser
+
The agent requires functional VSS providers. We rely 100% on Microsoft VSS for this - our
Agent bringt keine eigenen VSS-Provider mit. Wenn es seitens Microsoft-VSS Probleme gibt, kann es zu
+
Agent does not bring its own VSS providers. If there are problems on the part of Microsoft VSS, it can lead to
Fehlern kommen.
+
errors occur.
  
'''Lösung:''' <br>
+
'''Recommended Action:''' <br>
1. Überprüfen Sie den Zeitplan. Es ist nicht möglich mehrere Backupjobs zur gleichen Zeit auf dem System zu starten, da die VSS Komponenten dann konkurrieren. <br>
+
1. check the schedule. It is not possible to start multiple backup jobs at the same time on the system, as the VSS components will then compete. <br>
2. Starten Sie den Server einmal neu. Oftmals hilft ein Reboot um VSS-Probleme zu lösen. <br>
+
Restart the server once. Often a reboot helps to solve VSS problems. <br>
3. Installieren Sie alle verfügbaren Windows-Updates. <br>
+
3. install all available Windows updates. <br>
4. Für VSS Snapshots ist zusätzlicher Speicher erforderlich. Überprüfen Sie, ob Sie ausreichend freien Speicher auf dem System zur Verfügung haben (mind. 25GB). <br>
+
Additional memory is required for VSS snapshots. Check if you have enough free memory on the system (at least 25GB). <br>
5. Deaktivieren Sie fremde Backupsoftware (Acronis, Backup Exec, etc.). <br>
+
Disable third-party backup software (Acronis, Backup Exec, etc.). <br>
6.Die Größenbeschränkung des Shadowstorage sollte angepasst werden. Führen Sie folgenden Befehl pro Partition aus: <br>
+
6. the size limit of the shadow storage should be adjusted. Run the following command per partition: <br>
 
''vssadmin resize shadowstorage /for=<drive letter:> /on=<drive letter:> /maxsize=10GB'' <br>
 
''vssadmin resize shadowstorage /for=<drive letter:> /on=<drive letter:> /maxsize=10GB'' <br>
  
''Beispiel:'' <br>
+
''Example:'' <br>
 
''vssadmin resize shadowstorage /for=c: /on=c: /maxsize=10GB'' <br>
 
''vssadmin resize shadowstorage /for=c: /on=c: /maxsize=10GB'' <br>
 
''vssadmin resize shadowstorage /for=d: /on=d: /maxsize=10GB'' <br>
 
''vssadmin resize shadowstorage /for=d: /on=d: /maxsize=10GB'' <br>
7. Löschen Sie alte VSS Snapshots mit dem Befehl: <br>
+
7. delete old VSS snapshots with the command: <br>
 
:''vssadmin delete shadows /all''
 
:''vssadmin delete shadows /all''
8. Führen Sie folgenden Befehle aus und senden uns die Ausgabe: vssadmin list writers <br>
+
8. run the following command and send us the output: ''vssadmin list writers'' and ''vssadmin list providers'' <br>
9. Führen Sie folgenden Befehle aus und senden uns die Ausgabe: vssadmin list providers <br>
+
After setting, you would need to restart both TERRA CLOUD BACKUP services once. <br>
[[Datei:Vssadmin list providers.PNG|border|Aufgelistete VSS Provider]] <br>
+
Check the Windows Event Log. Look for "vss" and "volsnap" errors that occur around the time of the backup. <br>
'''Sofern auf dem System andere VSS Provider vorhanden sind, kann der folgende REG Key Abhilfe schaffen:''' <br>
+
:Often it helps to search the Internet for the event ID of the error to get a hint for the actual cause of the error. <br>
Sie könnten einmal über folgenden REG-Key versuchen den Agent dazu zu „zwingen" den Windows VSS-Provider zu nutzen: <br>
+
9a. Provided you have configured a file-based BMR job: <br>
''HKEY_LOCAL_MACHINE\SOFTWARE\EVault\InfoStage\Agent\UseSystemVSSProvider = 1'' <br>
+
Install the image plug-in and create an image-based BMR job. Test whether the behavior also occurs with it.
(DWORD) Nach dem Setzen müssten Sie einmal beide TERRA CLOUD BACKUP Services neustarten. <br>
+
9b. If you have configured an image-based BMR job: Uninstall the image plug-in and create a file-based BMR job. <br>
10. Überprüfen Sie die Windows Event Log. Suchen Sie nach "vss" und "volsnap" Fehlern welche um Zeitpunkt des Backups auftreten. <br>
+
Please include only "Bare Metal Restore" in the job. Test whether the behavior also occurs with it.
:Oft hilft es im Internet nach der Event-ID des Fehlers zu suchen um einen Hinweis für die eigentliche Fehlerursache zu bekommen. <br>
+
10. create VSS snapshot manually:<br>
11a. Sofern Sie einen filebasierten BMR-Job konfiguriert haben: <br>
+
:On Windows Server operating systems a VSS snapshot can be created via PowerShell, we recommend to test this once in case of VSS problems.<br>
:Installieren Sie das Image Plugin und erstellen Sie einen imagebasierten BMR Job. Testen Sie, ob das Verhalten auch damit auftritt.
+
:You can create a snapshot manually with the following command:<br>
11b. Sofern Sie einen imagebasierten BMR-Job konfiguriert haben: Deinstallieren Sie das Image Plugin und erstellen Sie einen filebasierten BMR Job. <br>
+
:''vssadmin create shadow /for=C:''<br>
:Bitte ausschließlich „Bare Metal Restore“ in den Job inkludieren. Testen Sie, ob das Verhalten auch damit auftritt.
+
:As an example, we have created a snapshot for C:, if this is not possible, there are fundamental VSS problems on the system that are not caused by the TERRA CLOUD Backup Agent. <br>
 
<br />
 
<br />
  
== Keine Verbindung zwischen Agent und Vault ==
+
=== VSS graphical user interface ===
'''Fehler:''' <br>
+
In addition to accessing the Microsoft Shadow Copy Service through PowerShell, you can also access it through a graphical interface. <br>
Beim Hinzufügen eines Vaults zu einem Computer erscheint die Fehlermeldung, dass der Agent keine Verbindung zum Vault aufbauen kann. <br>
+
Via this interface you can e.g:
 +
Configure the shadow storage on which the shadow copies are stored (e.g. define the size).
 +
# Manually create shadow copies, e.g. to check the functionality
  
'''Ursachen:''' <br>
+
From the properties of a volume, you can access the graphical interface via the "Shadow Copies" tab:
* Die eingegebenen Daten sind nicht korrekt.
+
[[Datei:VSS GUI.jpg|gerahmt|ohne]]
* Die Kommunikation wird aufgrund von geblockten Ports nicht ermöglicht.  
 
  
Die folgenden Ports müssen von innen nach außen freigegeben werden, damit die Kommunikation vom Agent zum Vault funktioniert: <br>
+
=== Force system VSS provider ===
 +
Using the following registry key, TERRA CLOUD Backup Agent always uses Microsoft Shadow Copy Provider 1.0:<br>
 +
 +
<code>HKEY_LOCAL_MACHINE\SOFTWARE\EVault\InfoStage\Agent\UseSystemVSSProvider = 1 (DWORD) </code> <br>
 +
<br>
 +
Please restart both TERRA CLOUD Backup services after this configuration:
 +
*TERRA Cloud Backup BUAgent
 +
*TERRA Cloud Backup Agent
 +
 
 +
=== Hyper-V VSS Writer exclusion ===
 +
'''Error pattern:''' <br>
 +
Backup jobs with the "BMR" option fail due to Microsoft VSS error messages on a Hyper-V host. <br>
 +
'''Problem:''' <br>
 +
Only the system partition on a physical Windows server ("host") with the Hyper-V role enabled is backed up. <br>
 +
The virtual machines (located on other partition) are explicitly backed up using the agent. <br>
 +
The Backup Agent on the HOST during the backup of drive C: also puts the VMs into the "backup in progress" state, i.e. activates a VSS functionality. <br>
 +
<br>
 +
'''Cause:'''<br>
 +
The backup agent only triggers the Microsoft VSS provider to put the system itself (not "just" what was included) into a consistent state. <br>
 +
At the time of snapshot creation, the operating system does not "know" that actually only C is affected.<br>
 +
Only the agent reads, compresses, encrypts, and transfers from the VSS snapshot only the data included in the job.<br>
 +
According to current knowledge, the Hyper-V VSS Writer is responsible for the described behavior.<br>
 +
<br>
 +
'''Solution:'''<br>
 +
A BMR backup of the Hyper-V host is not recommended, for a separate post on this see: [[Backup_Troubleshooting#Hyper-V_Server_Host_BMR Backup|Hyper-V Server Host BMR Backup]].
 +
If you still want to backup the C partition, please exclude the Hyper-V VSS Writer from the backup:<br>
 +
 
 +
'''Hyper-V VSS Writer Exclusion Guide:'''<br>
 +
 
 +
1.) Stop the TERRA CLOUD Backup Agent services using Powershell:<br>
 +
 
 +
''Get-Service -DisplayName "TERRA Cloud Backup*" | Stop-Service'' <br>
 +
 
 +
2.) In the installation directory you will find the job configuration files (<jobname>.vvc)<br>
 +
<br>
 +
 
 +
Example:<br>
 +
*"BMR.vvc".<br>
 +
<br>
 +
Create a copy of the job file, e.g. with the name "BMR.vvc.backup"<br>
 +
<br>
 +
Edit the job file "BMR.vvc" and add the following part to the end:<br>
 +
''VSSWriterBackup001 {''<br>
 +
''Name = Microsoft Hyper-V VSS Writer''<br>
 +
''InstName =''<br>
 +
''ID = 66841cd4-6ded-4f4b-8f17-fd23f8ddc3de''<br>
 +
''Include = ".\*"''<br>
 +
''Options = 4''<br>
 +
''}''
 +
<br>
 +
Provided that it is a cluster, there is certainly still a writer in the system for the cluster shared volumes (you can find out via vssadmin list writers). <br>
 +
Provided that this is the case, this Writer should also be excluded:<br>
 +
<br>
 +
''VSSWriterBackup002 {''<br>
 +
''Name = Cluster Shared Volume VSS Writer''<br>
 +
''InstName =''<br>
 +
''ID = 1072ae1c-e5a7-4ea1-9e4a-6f7964656570''<br>
 +
''Include = ".\*"''<br>
 +
''Options = 4''<br>
 +
''}''<br>
 +
<br>
 +
3.) Start the TERRA CLOUD Backup Agent services using Powershell:<br>
 +
''Get-Service -DisplayName "TERRA Cloud Backup*" | Start-Service''<br>
 +
<br>
 +
4.) Perform a backup <br>
 +
<br>
 +
5.) If the backup was not successful or the problem still occurs, please restore the previously saved job configuration file.<br>
 +
<br/>
 +
 
 +
=== VSS -E-05600 - System Writer missing - BMR not available ===
 +
 
 +
'''Error pattern:'''
 +
 
 +
You will receive the following error message in the log file:
 +
 
 +
''VSS -E-05600 Components of System Writer - no prescribed writer present (Writer ID E8132975-6F93-4464-A53E-1050253AE220)''
 +
 
 +
Additionally in your backup job in the backup selection that BMR is not available:
 +
 
 +
[[Datei:BMR ist nicht verfügbar.png|gerahmt|none]]
 +
 
 +
The Microsoft VSS System Writer is also not displayed in the Writer listing. <br>
 +
You can view the VSS Writer either in PowerShell or in CMD with the following command: <br>
 +
 
 +
''vssadmin list writers''
 +
 
 +
'''Cause:''' <br>
 +
The causes of a missing system writer can be very different, so each case must be considered individually. <br>
 +
Please note that a '''working''' Microsoft VSS service is the basis for all application consistent backups via TERRA CLOUD Backup. <br>
 +
This error pattern is basically a problem with the operating system itself and not with the backup agent. <br>
 +
 
 +
'''Recommendations for action:'''
 +
 
 +
* Please reboot the system and check again the VSS Writer
 +
* If the Writer is still not present, please check the Windows system event logs for Microsoft error codes
 +
* Try to back up the system via Windows Server Backup
 +
* Search with a Windows error code
 +
 
 +
'''Recommended Microsoft contribution to this error image:''' <br>
 +
 
 +
[https://docs.microsoft.com/en-us/archive/blogs/ntdebugging/missing-system-writer-case-explained Missing System Writer Case Explained]
 +
 
 +
==== Microsoft error code 0x80070018 associated with a missing System Writer ====
 +
'''Error pattern:''' <br>
 +
You will find the error code 0x80070018 VSS Error XML document is too long in the Windows Application Logs.
 +
 
 +
'''Recommended Action:''' <br>
 +
Please check the following article from Microsoft about this error pattern:
 +
 
 +
[https://support.microsoft.com/en-us/help/3098315/vss-error-xml-document-is-too-long-hr-0x80070018-error-when-you-perfor VSS Error XML document is too long]
 +
 
 +
'''Note:'''
 +
The System Writer is a part of the operating system, so we can only give you recommendations. Please contact Microsoft Support to resolve the issue.<br>
 +
 
 +
=== Backup, share is automatically included in BMR ===
 +
'''Error pattern:''' <br>
 +
In the job configuration, a network share appears below the "BMR" option, in addition BMR backups fail with VSS errors.<br>
 +
 
 +
[[Datei:Shareunterhalbbmr.png|border|BMR-Option]]
 +
 
 +
'''Recommended Action:''' <br>
 +
A registry key can be used to exclude a network path from the VSS snapshot, for example <br>
 +
1. windows + R to open the task "Run" and enter them "regedit". <br>
 +
2. navigate to the path HKEY_LOCAL_MACHINE\SOFTWARE\EVault\InfoStage\Agent. <br>
 +
3. add the string named WriterSelectionToIgnore. <br>
 +
4. start the extension with ^ <br>
 +
5. add an \ for each \ in the located path. <br>
 +
6. do not forget the * - symbol at the end. <br>
 +
:e.g.: ''^\\\\Name\\Folder1\\*.* ''<br>
 +
[[Datei:Regeditor.jpg|regedit Eintrag]]<br>
 +
 
 +
If no remedy is found after this configuration, it is possible that a service is stored on a network path.
 +
To do this, please check the system in question with the PowerShell query: <br>
 +
''Get-WmiObject win32_service | select Name, PathName''
 +
This command checks the storage path of the stored services, these may only be located on locally mounted volumes.
 +
 
 +
In this case, please also check the Microsoft VSS Writer details for network shares.
 +
Instructions on how to read these details can be found here: <br>
 +
[[Backup_Troubleshooting#Details_of_Microsoft_VSS_Writer_Read|Read details of Microsoft VSS Writer]]
 +
<br />
 +
 
 +
=== DISK-E-04205 - Error searching for file GLOBALROOT\Device\HarddiskVolumeShadowCopyXY\windows\\systemroot\system32\drivers\* ===
 +
'''Error pattern:''' <br>
 +
DISK-E-04205 Error searching for file GLOBALROOT\Device\HarddiskVolumeShadowCopyXY\windows\\system\root\system32\drivers\%NAME% <br>
 +
DISK-E-04101 Operating system message: The syntax for the file name, directory name, or volume name is incorrect. <br>
 +
 
 +
'''Cause:''' <br>
 +
The entry or reference in the registry indicates a non-existent or incorrect path.
 +
 
 +
'''Solution approach:''' <br>
 +
An adjustment of the path in the registry is necessary, you can find the respective reference under:<br>
 +
Computer\HKEY_Local_Machine\System\CurrentControlSet\Services\%DATEINAMEAUSErrorMESSAGE%<br>
 +
 
 +
We recommend that you export the corresponding entry before making any changes in the registry.<br>
 +
 
 +
Often an adjustment to the following entry is sufficient, if necessary you have to check the existing path and adjust the entry specifically:
 +
 
 +
%systemroot%\system32\DRIVERS\%FILEINAMEAUSERMESSAGE%.sys
 +
 
 +
After the entry has been adjusted, the system must be restarted to apply the change.
 +
 
 +
=== VSS -E-05658 VsscBackup::createSnapshotMap 2 internal error ===
 +
'''Error pattern:'''<br>
 +
You will get the following error image in the log file:
 +
 
 +
''VSS -W-05408 Error adding volume to snapshot set: volume <\?\Volume{'''GUID'''}\> <\?\Volume{'''GUID'''}\> (BS error: 0x8004230c VSS_E_VOLUME_NOT_SUPPORTED  )'' <br>
 +
''VSS -E-05658 VsscBackup::createSnapshotMap 2 internal error'' <br>
 +
''SV -E-09487 GetVolumeInformationW function failed for volume{'''GUID'''} (Operating system error: The device is not ready)'' <br>
 +
 
 +
'''Cause:'''<br>
 +
The Microsoft VSS service cannot create a snapshot for the complained volume because the volume (e.g. a USB stick) is not supported.
 +
This can be caused, for example, by the "Entire server" option in the backup set of a file-based backup job, since volumes are included in the backup for which no VSS snapshots can be created. In this case, please remove the option from the backup set and add the volumes to be backed up individually.
 +
 
 +
<font color="red">The error image regarding the "Entire server" option in connection with a file-based job has already been forwarded to the software manufacturer.</font>.
 +
 
 +
'''Recommended Action:'''<br>
 +
Please check which volume it is based on the GUID, you can use the following PowerShell script:
 +
 
 +
''Write-host "Please enter the GUID of the volume(the contents of the curly brackets)" <br>
 +
''$GUID = Read-Host'' <br>
 +
''$pattern = "\?\Volume{GUID}\"'' <br>
 +
''$pattern = $pattern.Replace("GUID", $GUID)'' <br>
 +
''Get-Volume -UniqueId $pattern | Select-Object -Property UniqueId,FileSystemLabel,DriveLetter | Out-GridView'' <br>
 +
 
 +
=== File cannot be checked for hard links (Windows\System32\LogFiles\Sum\无ǽ) ===
 +
'''Error pattern:'''<br>
 +
You will receive the following warning message in the log file:
 +
"File cannot be checked for hard links: \GLOBALROOT\Device\HarddiskVolumeShadowCopy14\Windows\System32\LogFiles\Sum\无ǽ (OS error (0x2): The system cannot find the specified file)." <br>
 +
'''Cause:'''<br>
 +
The operating system cannot check the listed file for hard links due to the special characters. <br>
 +
'''Solution:'''<br>
 +
These are standard files of a Microsoft installation, which are not relevant for the function of the server.<br>
 +
Thus, you can delete the \Sum folder (Windows\System32\LogFiles\Sum\) without any problems.<br>
 +
After that, the error will no longer appear in the log file and the backup will thus run through successfully again.<br>
 +
<br />
 +
 
 +
=== FAILED_AT_FREEZE - VSS_E_WRITERERROR_TIMEOUT)> 0x800423f2 ===
 +
 
 +
'''Error pattern:''' <br>
 +
You will receive the following error message in the log file:
 +
 
 +
''FAILED_AT_FREEZE(0x800423f2 -VSS_E_WRITERERROR_TIMEOUT)''
 +
 
 +
'''Cause:''' <br>
 +
A VSS writer times out when trying to bring its application into a consistent state. A cause for this can be performance problems of the system. <br>
 +
 
 +
'''Recommended Action:'''
 +
Please follow the usual steps for resolving VSS errors.
 +
If the error persists in subsequent backups, we recommend increasing the timeout for the VSS snapshot.
 +
The following article explains the increase of the timeout:
 +
https://blogs.technet.microsoft.com/asiasupp/2011/08/01/windows-server-backup-failed-to-backup-with-error-0x81000101/
 +
 
 +
=== VSS -E-05408 - VSS_E_UNEXPECTED_PROVIDER_ERROR ===
 +
==== Windows Agent ====
 +
'''Error pattern:''' <br>
 +
You will receive the following error message in the log file right after starting the backup:
 +
 
 +
''VSS -E-05408 Error adding volume to snapshot set: volume <\?\XY}\> <\\?\Volume{XY}\> (BS error: 0x8004230f VSS_E_UNEXPECTED_PROVIDER_ERROR)''<br>
 +
--- <br>
 +
''VSS -E-05408 error adding volume to snapshotset: Volume <\?\XY}\> <\?\Volume{XY}\> (OS error: 0x8004230f VSS_E_UNEXPECTED_PROVIDER_ERROR)''<br>
 +
 
 +
'''Cause:''' <br>
 +
TERRA CLOUD Backup Agent is trying to use an incorrect VSS provider. <br>
 +
 
 +
'''Solution:''' <br>
 +
Please use the following command via CMD or PowerShell to check which VSS providers are stored on the system.
 +
 
 +
''vssadmin list providers''
 +
 
 +
[[Datei:Vssadmin list providers.PNG|border|Aufgelistete VSS Provider]]<br>
 +
 
 +
The TERRA CLOUD Backup Agent must use Shadow Copy Provider 1.0.
 +
 
 +
'''Provided there are other VSS providers on the system, the following REG key can remedy the situation:''' <br>
 +
The entry ensures that the Shadow Copy Provider 1.0 is used when creating the snapshot for the TERRA CLOUD Backup Agent. <br>
 +
This must be created manually.<br>
 +
<br>
 +
 
 +
==== Hyper-V Agent ====
 +
'''Error pattern:''' <br>
 +
You will receive the following error message in the log file right after starting the backup:
 +
 
 +
''VSS -E-05408 Error adding volume to snapshot set: volume<\> <\>Volume{XY}\> (BS error: 0x8004230f VSS_E_UNEXPECTED_PROVIDER_ERROR)[Host1]''<br>
 +
--- <br>
 +
''VSS -E-05408 error adding volume to snapshotset: Volume <\?\XY}\> <\?\Volume{XY}\> (OS error: 0x8004230f VSS_E_UNEXPECTED_PROVIDER_ERROR)[Host1]''<br>
 +
 
 +
'''Cause:''' <br>
 +
TERRA CLOUD Backup Agent is trying to use an incorrect VSS provider. <br>
 +
 
 +
Example:<br>
 +
[[Datei:Acronis VSS SW Provider.png|border|Drittanbieter VSS Provider]]<br>
 +
 
 +
'''Solution:''' <br>
 +
#Determine the provider identifier (provider ID) from the output of the following command: vssadmin list providers
 +
#Run the registry editor (regedit)
 +
#Take a backup of the affected registry entries.
 +
#Delete the corresponding registry key from the following path: HKLM\System\CurrentControlSet\Services\VSS\Providers
 +
#Scan the registry for the provider ID and remove all existing references.
 +
#Open Component Services by typing "dcomcnfg" at the command prompt.
 +
#Open Component Services -> Computer -> COM+ Applications and remove the entry of the third-party VSS provider.
 +
#Then restart the affected host.
 +
 
 +
'''Note: This customization must be done per affected host!'''<br>
 +
<br>
 +
 
 +
=== VSS -E-05616 - 0x8004231f VSS_E_UNKNOWN ===
 +
'''Error pattern:''' <br>
 +
You will receive the following error message in the log file:
 +
 
 +
''VSS -E-05616 snapshot could not be created (OS error: 0x8004231f VSS_E_UNKNOWN (OS error (0x8004231F): unknown error code 0x8004231F))''
 +
 
 +
'''Cause:''' <br>
 +
This Microsoft error code can be caused by insufficient free space on a backed up volume or insufficient shadow copy space.
 +
 
 +
'''Recommended Action:''' <br>
 +
Please check via ''vssadmin list shadowstorage'' how much shadow copy storage is allocated to the volume and clean up or extend the volume until the free space exceeds that for shadow copy storage.
 +
 
 +
Test whether you can create a shadow copy by right-clicking on the drive in the Explorer "Configure Shadow Copies..." and creating a shadow copy for the volume with "Create Now". A functional BMR backup via TERRA CLOUD Backup can only be created if all volumes can successfully create a shadow copy.
 +
 
 +
=== VSS -W-05408 - 0x80042317 VSS_E_MAXIMUM_NUMBER_OF_SNAPSHOTS_REACHED ===
 +
'''Error pattern:'''<br>
 +
You will receive the following error message in the log file:
 +
VSS -W-05408 Error adding volume to snapshot set: Volume <\?\Volume{XY}\> <\?\Volume{XY}\> (BS error: 0x80042317 VSS_E_MAXIMUM_NUMBER_OF_SNAPSHOTS_REACHED)
 +
 
 +
'''Cause:'''<br>
 +
Microsoft VSS allows a maximum of 64 shadow copies on one system. It is not possible to request another shadow copy for the TERRA CLOUD backup, the agent passes on the message of the operating system in the log file.
 +
 
 +
'''Recommended Action:'''<br>
 +
Please check how many shadow copies exist on the system, for this you can enter the following command with administrative privilege in the command line:
 +
 
 +
''vssadmin list shadows
 +
''
 +
 
 +
These shadow copies should either be moved to another shadow copy store or deleted. <br>
 +
If another software solution based on Microsoft VSS is used, it should be ensured that there is no overlap between the backup windows.
 +
 
 +
=== Recommended Microsoft contributions to VSS ===
 +
 
 +
For comprehensive documentation on the Volume Shadow Copy Service, see:
 +
 
 +
[https://docs.microsoft.com/en-us/windows/win32/vss/volume-shadow-copy-service-portal Microsoft VSS Dokumentation]
 +
 
 +
=== Read details of Microsoft VSS Writer ===
 +
Each VSS writer is responsible for its own area, e.g. the system status or the registry. With the help of the following instructions, you can find out which directories and folders the respective writers are responsible for. This evaluation can be very helpful when analyzing a VSS problem, e.g. to locate an .exe file on a network share.
 +
Please note that "Diskshadow" is only available on server operating systems.
 +
 
 +
'''Instruction:'''
 +
# Please open the CMD with administrative permission
 +
# Create the "C:\temp" directory
 +
# Run the following command "DISKSHADOW /l c:\temp\diskshadow.txt".
 +
# Execute the following command "LIST WRITERS DETAILED".
 +
# You can find the output in the create "Temp" directory
 +
 
 +
<br />
 +
 
 +
== '''AFC Logs''' ==
 +
'''AFC''' stands for '''A'''gent '''F'''orensic '''C'''ollector, this tool collects backup and restore log files as well as other important information from a system on which a Windows Agent is installed. <br>
 +
These extensive log files are essential for the diagnosis of many error patterns.
 +
 
 +
=== AFC Logs Windows Agent ===
 +
 
 +
'''Download:''' <br>
 +
You can download the latest version of AFC Tool here: <br>
 +
https://backup.terracloud.de/download/afc.exe
 +
 
 +
'''Content and procedure:''' <br>
 +
# Run the afc.exe on the system where the agent is installed
 +
Please select the desired backup job via "Select Job".
 +
# Additionally select "Partition Info", "VShadows" and "Installed Applications", as shown in the screenshot
 +
# Upload the zip archive to TERRA Drive using the link below, no password is required:
 +
# [https://drive.terracloud.de/preparefilelink?folderID=29GiiJTeQn48ffqMeu91E AFC Logfile Upload]
 +
# Please provide a short upload confirmation to TERRA CLOUD Support
 +
 
 +
<br>
 +
[[Datei:AFC1.png|gerahmt|ohne]]
 +
 
 +
'''Note:''' <br>
 +
The VShadows option is only available on server operating systems.
 +
 
 +
=== AFC Logs Hyper-V Agent ===
 +
Please run the afc.exe on the system where the management component is installed (MGMT Agent).<br>
 +
In the "Custom Forensics" field, enter the path of the installation directory, as in the following screenshot:
 +
[[Datei:AFC2.png|gerahmt|ohne]]
 +
 
 +
=== AFC Logs Linux Agent ===
 +
'''Download:''' <br>
 +
You can download the latest version of AFC Tool here: <br>
 +
https://backup.terracloud.de/download/AFCforLinux.tar
 +
 
 +
For most derivatives, you can use the following command to perform the download:<br>
 +
''wget https://backup.terracloud.de/download/AFCforLinux.tar''
 +
 
 +
'''Collect log files:''' <br>
 +
# Please unpack the script with the following command: ''tar -xf AFCforLinux.tar'' <br>
 +
# Change via ''cd'' to the directory where you have unpacked the script
 +
# Check your permissions, depending on the derivative with ''su'' or ''sudo-i''
 +
# Please change the access rights for the afc_linux.sh script with the command ''chmod 777 afc_linux.sh''.
 +
# Then run the script via ''./afc_linux.sh''
 +
Follow the instruction in the script and specify your support ticket number, alternatively you can specify the order number of the backup package
 +
# Optionally you can add files (e.g. screenshots)
 +
# The AFC logs can be found in the /tmp/ directory with the name "AFC-< ticket_number >-<hostname>-<YYY-MM-DD-HH-MM-SS>.tar[.gz]".
 +
# [https://drive.terracloud.de/preparefilelink?folderID=29GiiJTeQn48ffqMeu91E AFC Logfile Upload]
 +
# Please provide a short upload confirmation to TERRA CLOUD Support
 +
 
 +
== '''TERRA CLOUD Backup Portal''' ==
 +
 
 +
=== Computer / Backup Agent is shown as offline since 01.01.0001 ===
 +
'''Error pattern:''' <br>
 +
The computer / backup agent is shown to you in the portal as "offline" since 01.01.0001, although the services of the agent are active.
 +
 
 +
The error pattern looks identical for the different agents (Windows, Linux, Hyper-V and VMware):
 +
[[Datei:01.01.0001.png|gerahmt|ohne]]
 +
 
 +
'''Cause:''' <br>
 +
The Backup Agent cannot communicate with the portal servers (AMP servers) via '''TCP port 8087'''.
 +
However, it was possible to register on the Backup Portal via '''TCP port 8086''', otherwise the system would not be displayed at all.
 +
 
 +
'''Solution:''' <br>
 +
Please release the '''TCP port 8087''' to the outside for the system on which the Backup Agent is installed.
 +
For more information, see the [[Backup#Network configuration|Network configuration]].
 +
 
 +
=== Users can only retrieve their own Vault profiles ===
 +
'''Error pattern:''' <br>
 +
You receive the following error message when attempting to register a system with the Vault:
 +
[[Datei:Eigene Vaultprofile.png|gerahmt|none]]
 +
'''Cause:''' <br>
 +
This error message appears because not all portal servers can access this Vault profile yet. <br>
 +
It can take up to 5 minutes to pass the information to all portal components. <br>
 +
'''Solution:''' <br>
 +
Logging in again may speed up this process and thus resolve this error message. <br>
 +
 
 +
=== UPDT-E-10320 - Could not upgrade the Agent. The system must be restarted ===
 +
 
 +
'''Error pattern:''' <br>
 +
You will receive the following message in the Backup Portal after starting the upgrade process:
 +
''You must restart this computer for the change to the agent software configuration to take effect.''
 +
[[Datei:Agent Upgrade Center.png|gerahmt|ohne]]
 +
 
 +
 
 +
In BUAgent logfile you can find the following error code for this: <br>
 +
''UPDT-E-10320 Could not upgrade the Agent. The system must be restarted''
 +
 
 +
'''Cause:''' <br>
 +
A registry key on the system to be backed up prevents the agent from being updated. This key is usually cleared by a reboot.
 +
 
 +
'''Recommended Action:''' <br>
 +
Please check the following article for this, as the procedure is identical: <br>
 +
[https://wiki.terracloud.de/index.php/Backup_Troubleshooting#Ausstehender_Neustart.2FPending_Reboot Pending Restart]
 +
 
 +
== '''Windows Agent''' ==
 +
 
 +
=== Windows Agent General ===
 +
 
 +
==== No connection between agent and vault ====
 +
'''Error:''' <br>
 +
When adding a vault to a computer, the error message appears that the agent cannot connect to the vault. <br>
 +
 
 +
'''Causes:''' <br>
 +
* The data entered is not correct.
 +
* Communication is not possible due to blocked ports.
 +
 
 +
The following ports must be enabled from the inside out for communication from the agent to the Vault to work: <br>
 
* 2546 TCP
 
* 2546 TCP
* 2547 TCP (nur für die Replikation des Satelliten zum Basevault)
+
* 2547 TCP (only for replication of the satellite to the basevault).
  
'''Überprüfung:''' <br>
+
'''Review:''' <br>
Bitte führen Sie folgende Tests von dem System aus auf dem der Agent installiert ist: <br>
+
Please run the following tests from the system on which the agent is installed:<br>
 
* ping backup.terracloud.de
 
* ping backup.terracloud.de
* ping vault-wmh1-p002.terracloud.de
+
* ping vault-wmh1-p002.terracloud.de  
 
* telnet vault-wmh1-p002.terracloud.de 2546
 
* telnet vault-wmh1-p002.terracloud.de 2546
 +
Alternatively via PowerShell:
 +
* test-netconnection vault-wmh1-p002.terracloud.de -port 2546
 +
(Please use the correct Vault address at this point, see email with credentials) <br>
 +
 +
'''Solution:''' <br>
 +
Please check the access data, copy them 1:1 from the email "Your TERRA CLOUD Backup Account". <br>
 +
If the connection attempts fail, please release the corresponding ports. <br>
 +
<br />
 +
 +
==== Native protected data amount differs from actual memory consumption ====
 +
 +
'''Error pattern:''' <br>
 +
The natively protected amount of data is incorrectly displayed in the Backup Portal in the job details or in a report.
 +
 +
'''Unlimited VSS shadow copy storage:'''<br>
 +
For each volume shadow copy storage is defined by the operating system, the maximum size can be set either as a total value e.g. 10240MB or "unlimited". <br>
 +
Please check if a fixed and therefore not unlimited shadow copy storage is defined for '''all''' volumes.
 +
 +
'''Large shadow copy memory:'' <br>
 +
The size of the shadow copy is included in the calculation of the natively protected amount of data. <br>
 +
Particularly large volumes that are hardly occupied create a discrepancy between the actual amount of data occupied and the amount of data measured by the agent.
 +
 +
'''Example of a large volume:'' <br>
 +
You add a new volume with 1TB capacity to a system that you want to back up. For this volume, 50GB is set aside by default for shadow copies.
 +
When backing up the entire volume, these 50GB would be included in the calculation of the native amount of data protected.
 +
Please reduce the shadow copy storage for this volume to a much smaller value.
 +
If the volume occupancy increases, you can always increase the shadow copy storage.
 +
 +
'''Cause of deviation for a large shadow copy memory:'' <br>
 +
Backup jobs that back up an entire volume, e.g. image jobs or BMR backups also measure the reserved space during the backup, which is released after the backup.
 +
You can observe this during the backup as the occupied memory increases for the duration of the backup.
 +
The development team of our software manufacturer is already working on an optimization of the measurement timing.
 +
 +
'''Configuration of the shadow copy memory:'''<br>
 +
You can make the shadow copy storage via the [https://wiki.terracloud.de/index.php/Backup_Troubleshooting#VSS_grafische_Oberfl.C3.A4che graphical interface].<br>
 +
The limitation for the System Reserved Partition can only be configured via the properties in the graphical user interface, since no drive letter is assigned for it.
 +
 +
Alternatively, you can also perform the configuration via CMD or PowerShell:<br>
 +
 +
<code>vssadmin resize shadowstorage /for=<drive letter:> /on=<drive letter:> /maxsize=10GB </code>
  
(Bitte verwenden Sie an dieser Stelle die korrekte Vault-Adresse, siehe Email mit Zugangsdaten) <br>
+
'''Example:''' <br>
 +
<code>vssadmin resize shadowstorage /for=c: /on=c: /maxsize=10GB </code> <br>
 +
<code>vssadmin resize shadowstorage /for=d: /on=d: /maxsize=10GB </code> <br>
  
'''Lösung:''' <br>
+
'''Windows Server Deduplication:''' <br>
Bitte prüfen Sie die Zugangsdaten, kopieren Sie diese 1:1 aus der Email „Ihr terra CLOUD Backup Account“. <br>
+
This Windows Server role enables deduplication of data on the server. You can see the compressed and deduplicated dataset via the Windows Explorer.<br>
Sollten die Verbindungsversuche fehlschlagen geben Sie bitte die entsprechenden Ports frei. <br>
+
However, the Backup Agent transmits the '''uncompressed''' original size of the backup set as meta information.
<br />
 
  
== Keine Verbindung zwischen Agent und Portal ==
+
Please use the following PowerShell command to check if the role is installed on the server in question: <br>
'''Fehler:''' <br>
+
<code> Get-WindowsFeature -Name FS-Data-Deduplication </code>  
Beim Installieren des Agents auf einem Zielsystem, kann der Agent sich nicht gegenüber dem Portal authentifizieren. <br>
 
  
'''Ursachen:''' <br>
+
'''Should the role be installed:''' <br>
* Die eingegebenen Daten sind nicht korrekt.
+
Please exclude the "Chunk Store" folder below the "System Volume Information" directory from the backup.
* Die Kommunikation wird aufgrund von geblockten Ports nicht ermöglicht.
+
After the next backup is completed, the measured natively protected data volume should be correct again.
* Der Port 8086 TCP muss von innen nach außen freigegeben werden.
 
  
'''Überprüfung:''' <br>
+
'''Recommendations:'''<br>
Bitte führen Sie folgende Tests von dem System aus auf dem der Agent installiert ist: <br>
+
To determine and analyze the used space on a volume, we recommend, in addition to Windows Explorer, the free tool [https://www.jam-software.de/treesize_free TreeSize Free].
* telnet backup.terracloud.de 8086
 
  
'''Lösung:''' <br>
+
==== Invalid file format or delta mapping file is corrupted ====
Bitte prüfen Sie die Zugangsdaten, diese wurden von Ihnen innerhalb des Backup Portals selbst definiert. <br>
 
Sollten die Verbindungsversuche fehlschlagen geben Sie bitte die entsprechenden Ports frei. <br>
 
  
== Ausstehender Neustart/Pending Reboot ==
+
'''Error pattern:''' <br>  
'''Fehler:''' <br>
+
''Jun 07 22:15:38 DELT-E-04355 Invalid file format C:\Program Files\TERRA Cloud Backup\Agent\JOBNAME\0000xxxx.DTA'' <br>
Bei der Installation des Agents erhält man die Fehlermeldung das ein Neustart des Systems aussteht. (Pending reboot) <br>
+
''Jun 07 22:15:38 BKUP-E-08196 Your delta mapping file is corrupted. Delete the file, or rename it, and synchronize it with your director. [VV]'' <br>
  
'''Ursachen:''' <br>
+
'''Cause:''' <br>
Der Agent prüft einen Registry-Schlüssel. Windows sollte normalerweise bei jedem Neustart diesen Schlüssel leeren.  
+
The error message says that the delta file (0000000X.DTA) or the delta assignment file (0000000X.DTX) is damaged.
Sporadisch wird dies aber nicht gemacht, sodass der Agent "denkt" dass noch ein Neustart aussteht. Bitte beachten Sie, dass bei manuellen Änderungen der Registry zuvor eine Sicherung der Registry durchgeführt werden sollte!
+
The delta file contains checksums of the already saved blocks, the delta allocation file is an index file for the delta file.
 +
This file is needed so that the agent knows which blocks have already been saved and which are new or have changed.
  
'''Lösung:''' <br>
+
'''Solution:''' <br>
''KEY:'' <br>
+
Please perform a backup reset, instructions can be found in the following entry for a very similar error:
''HKLM\SYSTEM\\CurrentControlSet\\Control\\SessionManager VALUE: "PendingFileRenameOperations"'' <br>
+
[https://wiki.terracloud.de/index.php/Backup_Troubleshooting#DELT-E-05782_-_Delta_file_corrupted_0000000X.DTA_file_is_corrupted:_hash_mismatch DELT-E-05782 - Delta file damaged 0000000X.DTA file is damaged: hash mismatch]
  
Diesen Schlüssel bitte öffnen und den Inhalt herauslöschen, im Anschluss sollte die Installation reibungslos verlaufen. <br>
+
==== A value is required for Server0.Password ====
 +
'''Error pattern:'''<br>
 +
A backup fails immediately after startup with the following message in the log files:<br>
  
== Uhrzeit im Satellit stimmt nicht ==
+
''PARS-E-05152 A value is required for Server0.Password'' <br>
'''Ursachen:''' <br>
+
<br>
Die Bandbreitenlimitierung hält sich an die empfangende Uhrzeit. Wenn die Uhrzeit nicht synchron ist, funktioniert der Plan nicht korrekt. <br>
+
'''Cause:'''<br>
'''Lösung:''' <br>
+
A configuration file (global.vvc) is missing the hash value for the vault password.<br>
Bitte Port NTP Port 123/UDP vom Satelliten ins Internet freigeben. <br>
+
Without this entry, the agent cannot authenticate to the vault system.<br>
 +
<br>
 +
'''Solution:'''<br>
 +
Please store the Vault password in the Backup Portal again, to do this please go to "Vault Settings" and edit the existing configuration:<br>
 +
See also [https://wiki.terracloud.de/index.php/Backup#Vault_Profile_konfigurieren 2.1.1]
  
== User has no permissions to access user agents ==
+
==== DELT-E-05782 - Delta file corrupted 0000000X.DTA file is corrupted: hash mismatch ====
'''Fehler:''' <br>
+
'''Error pattern:''' <br>
Bei der Konfiguration des ersten Backup Jobs für einen Computer erhält man die Fehlermeldung "User has no permissions to access user agents". <br>
+
You receive the following error message in the log file of a backup job: <br>
 +
''DELT-E-05782 C:\Program Files\TERRA Cloud Backup\Agent\Jobname\0000000X.DTA file is corrupted: hash mismatch''<br>
  
'''Ursachen:''' <br>
+
The error message says that the delta file (0000000X.DTA) is corrupted, this file contains checksums of the backed up blocks of the last backup.<br>
Normalerweise handelt es sich hierbei um ein Cachingproblem. <br>
+
This file is needed so that the agent knows which blocks have already been backed up and which are new or have changed.<br>
  
'''Lösung:'''
+
'''Solution:''' <br>
Hier kann es helfen wenn Sie sich einmal abmelden und anschließend wieder einloggen. Sollte das nicht direkt funktionieren müssten Sie eine kurze Zeit warten. <br>
+
Please run the following PowerShell script on the agent system: <br>  
Im Anschluss sollte die Konfiguration problemlos fortgeführt werden können. Alternativ können Sie sich mit dem Benutzer der Subsite einloggen und die Konfiguration vornehmen. <br>
+
[https://drive.terracloud.de/dl/fiNfcS3QkGrRKLxkLqzteJPp/BackupReset.exe Backup Reset Script]
== Acronis VSS Provider entfernen ==
+
<br>
Einen entsprechenden Workaround bietet Ihnen der folgende Link: <br>
+
Among other things, this script deletes the corrupted delta file and performs a synchronization, in the process the delta file is recreated.<br>
https://forum.acronis.com/de/forum/11602 <br>
+
A synchronization can take some time depending on the system size.<br>
 +
After the execution, the encryption password must be entered again. <br>
 
<br />
 
<br />
  
== Fehler 1722 bei der Deinstallation des Backup Agents ==
+
==== Illegal function ====
Schritt 1: Falls vorhanden deinstallieren Sie Visual C++ redists "2008 x86 9.0.30729.4148" von Ihrem System, sollte das Paket nicht installiert sein, fahren Sie bitte mit Schritt 2 fort. <br>
+
'''Error pattern:'''<br>
Schritt 2: Bitte benennen Sie die "global.vvc" innerhalb des Installationsverzeichnisses um in "globalold.vvc“. <br>
+
The affected system is displayed as "Offline" in the Backup Portal, even though it is in use.<br>
Schritt 3: Versuchen Sie nun den Agenten zu deinstallieren.
+
The "TERRA Cloud Backup BUAgent" service is not running:<br>
 +
<br>
 +
[[Datei:BackupDienste.png|border|Auflistung der Terra Backup Dienste]]<br>
 +
<br>
 +
When you try to start the service, you will receive the following error message:<br>
 +
<br>
 +
[[Datei:Unzulässige Funktion.png|border|Unzulässig Funktion]]<br>
 +
<br>
 +
'''Cause:'''<br>
 +
The "TERRA Cloud Backup BUAgent" service accesses a configuration file (global.vvc) in the installation directory of the agent, among other things, settings for the agent are stored in this file, <br>
 +
that you have configured in the portal (e.g. a bandwidth limit).<br>
 +
With this error pattern, this configuration file is empty, incomplete or corrupted. <br>
 +
Without a proper global.vvc file, the agent cannot back up.<br>
 +
<br>
 +
'''Recommended Action:'''<br>
 +
For troubleshooting, the global.vvc file in the installation directory can be opened first, e.g. with the editor. In this case the file is empty.<br>
 +
<br>
 +
[[Datei:Global.vvc.png|border|600px|leere Global.vvc Datei]]<br>
 +
<br>
 +
This empty global.vvc can be removed. <br>
 +
After deleting the file you can perform a repair installation of the agent, to do this you need to enter the setup of the agent and select the following option:<br>
 +
<br>
 +
[[Datei:Reparaturinstallation BUAgent.png|border|Reparaturinstallation]]<br>
 +
<br>
 +
After successful repair installation, the global.vvc file will be filled with content.<br>
 +
Now please store the Vault password again in the Backup Portal, you can find instructions on how to do this under the item [https://wiki.terracloud.de/index.php/Backup_Troubleshooting#F.C3.BCr_Server0.Password_ist_ein_Wert_erforderlich "A value is required for Server0.Password"]<br>
 +
If the error pattern cannot be solved with these steps, a complete uninstallation followed by an installation of the agent can help, in which the configuration files (including the global.vvc) are downloaded from the vault system and stored in the agent directory. <br>
 
<br />
 
<br />
  
== Problem beim Backup QNAP NAS mit UNC Pfade ==
+
==== Hyper-V Server Host BMR Backup ====
Bitte gehen Sie auf das Agentensystem und öffnen die Jobkonfiguration: <br>
+
Backing up physical Hyper-V hosts that are actively running VMs has been known to cause problems with Microsoft VSS. Microsoft VSS tries to put the COMPLETE system (including CSVs) into a consistent state. <br>
C:\Program Files\TERRA Cloud Backup\Agent\<JOBNAME>.vvc" <br>
+
To enable this, all virtual machines would therefore also have to be paused. Since no VSS snapshot is triggered via the Integration Services via the agent-based backup, there are problems here. <br>
Hier finden Sie den Eintrag Ignore_Security. Dieser Schalter legt fest, ob auch die ACLs gesichert werden sollen oder nicht. QNAP erlaubt so die Sicherung der ACLs über diesen Weg nicht.  
+
<br>
Von daher sollte der Schalter auf TRUE gesetzt werden. <br>
+
The question generally arises as to why hypervisor servers should be backed up at all.<br>
Anschließend sollten die beiden terra CLOUD Backup Dienste neugestartet werden. <br>
+
Enclosed are sample articles from the web:<br>
 +
*http://www.altaro.com/hyper-v/hyper-v-backup-strategies-dont-worry-management-os/ <br>
 +
*https://www.backupassist.com/blog/support/10-tips-for-best-practice-hyper-v-backups/ <br>
 +
*https://www.veeam.com/blog/hyper-v-hosts-to-back-up-or-not-to-back-up.html <br>
 +
<br>
 +
Individual files and folders can be backed up without problems - only BMR has problems. <br>
 +
<br>
 +
For the reason it is also not supported See [https://wiki.terracloud.de/index.php/Backup#Funktions.C3.BCbersicht function overview] <br>
 +
With host-based backup from version 8.60 ONLY the VMs can be backed up, not the host itself (also no files and folders).<br>
 +
<br>
 +
'''We recommend agent-based backup (from within the VM) to take full advantage of the backup solution's features.'' <br>
 +
'''Provided a Hyper-V host fails completely, it should be reinstalled and added back to the cluster.''' <br>
 
<br />
 
<br />
  
== Backup Host Agent Fehler 0x800706d9 ==
+
==== Backup jobs pile up in a queue at ====
[[Datei:Agent Fehler x800706d9.jpg|Backup Agent Fehler x800706d9]] <br>
+
'''Error pattern:''' <br>
Sofern es sich dabei nicht um ein Cluster System handelt und eine Failover Cluster Rolle installiert ist. <br>
+
You see several processes in the queue in the Backup Portal for one system, the current backup job no longer shows any progress.
– Diese Rolle bitte deinstallieren, danach sollte man sich erfolgreich registrieren können. <br>
+
 
Der Agent überprüft: <br>
+
'''Recommended Action:''' <br>
* Wenn keine Failover Cluster Rolle installiert ist => Verbinden Sie sich mit Hyper-V <br>
+
Please restart the TERRA CLOUD Backup services so that the open processes are terminated. <br>
* Wenn Failover Cluster Rolle installiert ist => Verbinden Sie sich mit der Clusterinstanz <br>
+
 
 +
''Get-Service -DisplayName "TERRA Cloud Backup*" | Stop-Service'' <br>
 +
''Get-Process | ? ProcessName -Match "VV|VVAgent" | Stop-Process -Force''<br>
 +
''Get-Service -DisplayName "TERRA Cloud Backup*" | Start-Service''<br>
 +
 
 
<br />
 
<br />
  
== Sicherheitsdatenverarbeitung aufgrund unzureichender Berechtigung deaktivieren ==
+
==== SMTP Prober / Mail Notification ====
Die Fehlermeldung deutet darauf hin, dass für einige Verzeichnisse auf Ihrem System die Eigenschaft „Compress Advanced Attribute" aktiviert ist.<br>
+
'''Error pattern:''' <br>
Um diese Verzeichnisse zu lokalisieren können Sie den Job einmal mit einem anderen Log-Level ausführen. Bitte bearbeiten Sie hierzu Ihren Job und wählen als „Optionen für Protokolldatei:" die Option „Directory" aus. <br>
+
The Backup Agent does not send mails according to the defined criteria. <br>
Führen Sie im Anschluss das Backup erneut aus, nun sollten Sie unterhalb der unten aufgezeigten Zeile Hinweise auf die Verzeichnisse finden die diese verursachen. <br>
+
You will receive the following or similar messages in the log file of your backup job: <br>
Lokalisieren Sie diese Ordner und entfernen Sie in den Eigenschaften->Erweitert den Punkt „Inhalt komprimieren, um Speicherplatz zu sparen". <br>
+
[[Datei:Mailbenachrichtigung.png|gerahmt|ohne]]
Diese Form der Protokollierung kann unter Anderem große Logfiles erzeugen daher sollte dieser Typ nur temporär genutzt werden. <br>
+
 
Sofern Sie Dateien mittels UNC Freigabe von einem NAS sichern kann außerdem folgendes abhilfen schaffen (dieser Schritt sollte nur ausgeführt werden, sofern der u.g. Lösungsweg keine Abhilfe schafft): <br>
+
'''Recommended Action:''' <br>
Bitte gehen Sie auf das Agentensystem und öffnen die Jobkonfiguration: <br>
+
You can test the stored settings via the Backup Portal. If the test is not successful, you can perform the following steps:
* C:\Program Files\TERRA Cloud Backup\Agent\<JOBNAME>.vvc" <br>
+
# Update the agent to the latest version, as the mail notification feature has been updated to current standards in newer agent versions. <br>
Hier finden Sie den Eintrag Ignore_Security. Dieser Schalter legt fest, ob auch die ACLs gesichert werden sollen oder nicht. QNAP beispielsweise erlaubt so die Sicherung der ACLs über diesen Weg nicht. <br>
+
# As an alternative to port 25, check port 587 or 465. <br>
Von daher sollte der Schalter auf TRUE gesetzt werden. <br>
+
Please check once with SMTP Prober Tool if the mails can be sent from the system in general.
Anschließend sollten die beiden terra CLOUD Backup Dienste neugestartet werden. <br>
+
 
 +
'''SMTP Prober'''<br>
 +
You can download the tool from the following link: http://www.alexnolan.net/software/SMTPProber.htm <br>
 +
If you can successfully send mails from the system with the tool, it is ensured that the communication with the mail server can be established.
 
<br />
 
<br />
  
== Backup "Job kann nicht beim Vault registriert werden. Er ist möglicherweise bereits im Vault vorhanden." (Gilt für Satelliten Vault-Accounts) ==
+
==== GetVolumeNameForVolumeMountPointW() failed ====
Sofern Ihr Vault-Account auf Normal Operation steht, kann ein Computer registriert werden – auch mit der Zieladresse des BaseVaults. <br>
+
'''Cause:'''<br>
Ersetzt man die Ziel-Adresse mit der des lokalen Satelliten funktioniert alles wie gewünscht. <br>
+
This can happen when database files (MDF or LDF) exist on either a mount point or a symbolic link, rather than in a normal physical location.<br>
 +
''Example:''<br>
 +
You have your logical location for the database files in C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\DATA, but you have created a symbolic link to the data that exists on another drive:<br>
 +
[[Datei:Pfad der DB-Dateien ändern.png|border|Pfad muss angepasst werden]]<br>
 +
<br>
 +
'''Solution:'''<br>
 +
The location for the MDF and LDF files must be updated. <br>
 +
One way to do this is to detach the database and then attach it again. <br>
 +
If the database is attached, make sure to select the MDF file in the current location ''(D:\Data\MSSQL\DATA in the above example)''. <br>
 +
Once the logical reference is updated to the correct path, the backup is successful.<br>
 
<br />
 
<br />
  
== Ungültiges Dateiformat oder Deltazuordnungsdatei ist beschädigt ==
+
=== Windows Agent Installation ===
'''Beispiel:''' <br>  
+
-----
''07.jun. 22:15:38 DELT-E-04355 Ungültiges Dateiformat C:\Program Files\TERRA Cloud Backup\Agent\JOBNAME\0000xxxx.DTA'' <br>
+
==== The installation package is not supported by this processor type ====
''07.jun. 22:15:38 BKUP-E-08196 Ihre Deltazuordnungsdatei ist beschädigt. Löschen Sie die Datei, oder benennen Sie sie um, und synchronisieren Sie sie mit Ihrem Director. [VV]'' <br>
+
'''Error pattern:''' <br>
 +
When installing the agent, you get the following error screen:
 +
[[Datei:Prozessortyp.png|none]]
 +
 
 +
'''Cause:''' <br>
 +
The executed setup is not compatible with the used processor type (64 bit or 32 bit).  
 +
 
 +
'''Solution:''' <br>
 +
Please use the appropriate setup for the processor type used.
 +
 
 +
==== Pending restart ====
 +
'''Error:''' <br>
 +
When installing the agent, you will receive the following message:<br>
 +
 
 +
[[Datei:Pending Reboot-1.png]]
 +
 
 +
'''Cause:''' <br>
 +
The operating system creates the "RebootRequired" registry key. TERRA CLOUD Backup Agent checks if this key exists before installation. <br>
 +
 
 +
<code>HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\RebootRequired </code> <br>
 +
 
 +
[[Datei:Pending Reboot.png|600px]]
  
'''Lösung:''' <br>
+
'''Recommended Action:''' <br>
Die Jobs synchronisieren. <br>
+
Please perform the reboot before installing the agent, because e.g. recommended Windows updates require a reboot after their installation.
Sollte das Problem dadurch nicht behoben werden muss der Agent neu installiert werden. <br>
 
Gehen dann wie folgt vor: <br>
 
1. Löschen Sie den Agenten vollständig vom System und entfernen Sie übrig gebliebene Dateien ggf. per Hand <br>
 
2. Installieren Sie den Agenten wie gewohnt neu <br>
 
3. im Backupportal sollte nun ein Offlineserver zu sehen sein. Diesen können Sie löschen <br>
 
4. Bei dem neuen Server im Backupportal unter "Vault-Einstellungen" bitte "Erneut registrieren" wählen, Vault Einstellungen laden und unten rechts das System wieder auswählen <br>
 
5. Nach einigen Sekunden können Sie die Seite "Computer" neu laden und Sie sehen wieder die "alten" Jobs <br>
 
6. Jeweils die Jobs bearbeiten und das Passwort eingeben (dieses kann nicht rekonstruiert werden, da das Job-Passwort auf dem Vault nicht gespeichert wird) <br>
 
7. Jeweils die Jobs synchronisieren, dadurch werden die Delta-Dateien auf dem Agenten neu erstellt <br>
 
8. Nun bitte nochmal eine Sicherung starten <br>
 
 
<br />
 
<br />
  
== Backup Satellit kein Heartbeat vor Version 0.10.11 ==
+
==== Backup Host Agent Error 0x800706d9 ====
'''Lösung:''' <br>
+
'''Error pattern:''' <br>
Das Windows-Update KB3142036 ist für den Fehler verantwortlich. <br>
+
When registering the system, you will receive the following error message in the Backup Portal<br>
Ein Update auf die v0.10.11 behebt das Problem. Alternativ kann das KB manuell deinstalliert werden. <br>
+
<br>
<br />
+
[[Datei:Agent Fehler x800706d9.jpg|Backup Agent Fehler x800706d9]]
 +
 
  
== Die Anmeldeinformationen für das Plug-in konnten aufgrund eines unerwarteten Fehlers nicht überprüft werden. Überprüfen Sie, ob die Anmeldeinformationen korrekt sind, und versuchen Sie es erneut ==
+
'''Solution:'''<br>
Das EVault Oracle Plug-In nutzt die Verbindung zur zu der Oracle Datenbank EZCONNECT. Stellen Sie sicher, dass Ihre Konfiguration in der sqlnet.ora Datei Ok ist. <br>
 
z.B.: <br>
 
''# SQLNET.ORA Network Configuration File: d:\oracle\ora92\network\admin\sqlnet.ora'' <br>
 
''# Generated by Oracle configuration tools.'' <br>
 
''SQLNET.AUTHENTICATION_SERVICES= (NONE)'' <br>
 
''NAMES.DIRECTORY_PATH = (EZCONNECT,TNSNAMES)'' <br>
 
  
Starten Sie Oracle listener und versuchen Sie es erneut mit einem Backup. <br>
+
Please check if it is a cluster node with failover cluster role installed it is not a cluster system. <br>
 +
* If the system is not part of a cluster, please uninstall the Failover Cluster role<br>
 +
The agent checks: <br>
 +
* If no failover cluster role is installed => Connect to Hyper-V <br>
 +
* If Failover Cluster role is installed => Connect to the cluster instance <br>
 
<br />
 
<br />
  
== Sevice Manager failed to get current information ==
+
==== No connection between agent and portal ====
Diese Fehlermeldung erscheint nachdem das Passwort für den Backup-Job Restore Point eingegeben wurde. <br>
+
'''Error:''' <br>
[[Datei:System Restore Wizard PW.jpg|System Restore Wizard]] <br>
+
When installing the agent on a target system, the agent cannot authenticate to the portal. <br>
[[Datei:System Restore failed.jpg|Device Manager failed to get current information]] <br>
+
 
 +
'''Causes:''' <br>
 +
* The data entered is not correct.
 +
* Communication is not enabled due to blocked ports.
 +
* Ports 8086 and 8087 TCP must be enabled from the inside out.
  
'''Lösung:'''<br>
+
'''Review:''' <br>
Der SCSI Controller Treiber von "Paravirtual" muss auf "LSI Logic SAS" abgeändert werden. <br>
+
Please run the following tests from the system on which the agent is installed: <br>
<br />
+
* telnet backup.terracloud.de 8086
 +
* telnet amp01.terracloud.de 8087
 +
* telnet amp10.terracloud.de 8087
 +
* telnet amp20.terracloud.de 8087
  
== SQL Backup Jobs lässt sich nach einer Änderung der Credentials nicht bearbeiten ==
+
Alternatively, you can run the following commands in PowerShell: <br>
'''Lösung:'''
+
''1 .. 20 | ForEach-Object { Write-Host "amp$(($_).ToString("00")).terracloud.de" : $(Test-NetConnection "amp$(($_).ToString("00")).terracloud.de" -Port 8087).TcpTestSucceeded } <br>
Legen Sie vor dem Ändern der Dateien eine Sicherungskopie an! <br>
+
Test-NetConnection backup.terracloud.de -Port 8086'' <br>
1. Legen Sie einen neuen SQL Job mit den neuen Windows-Credentials an. <br>
 
2. Sie finden im Installationsverzeichnis des Agenten die Datei „JOBNAME.vvc“ <br>
 
3. Kopieren Sie den Absatz „WindowsCredentials“ von Ihren Testjob in die .vvc des richtigen Backup Jobs <br>
 
  
Im Anschluss konnte der Backup Prozess fortgesetzt werden. <br>
+
'''Solution:''' <br>
 +
Please check the access data, these were defined by you within the backup portal itself. <br>
 +
If the connection attempts fail, please release the corresponding ports. <br>
 
<br />
 
<br />
  
== Backup, Share wird automatisch im BMR inkludiert ==
+
==== Agent Upgrade Utility stops working / MAPI job upgrade ====
'''Lösung:''' <br>
+
'''Error:'''<br>
Zum Ignorieren der bestimmten Auswahl der VSS, muss ein Eintrag in der Registry erstellt werden. <br>
+
Agent Setup hangs and a window appears with the info "Agent Upgrade Utility stopped working". <br>
1. Windows + R zum Öffnen des Tasks “Ausführen” und tragen sie „regedit“ ein. <br>
+
Then as soon as you click on "Close Program", a MAPI job upgrade window opens.<br>
2. Zum Pfad HKEY_LOCAL_MACHINE\SOFTWARE\EVault\InfoStage\Agent navigieren. <br>
+
<br>
3. Fügen Sie die Zeichenreihenfolge namens WriterSelectionToIgnore hinzu. <br>
+
[[Datei:Agent Upgrade Utility.png|border|600px]]<br>
4. Starten Sie die Erweiterung mit ^ <br>
+
<br>
5. Fügen Sie ein \\ für jedes \ in dem befindlichen Pfad. <br>
+
[[Datei:MAPI-Jobupgrade.PNG|border|600px]]<br>
6. Am Ende das * - Symbol nicht vergessen. <br>
+
<br>
:z.B.:^\\\\Name\\Folder1\\.*
+
'''Solution:'''<br>
[[Datei:Regeditor.jpg|regedit Eintrag]]
+
Please run the setup again and stop at the first step.<br>
 +
<br>
 +
Then download the following .zip file:<br>
 +
[https://drive.terracloud.de/dl/fi5rVctgmVWGGaR3vU66STpt/Agent%20Upgrade%20Utility%20funktioniert%20nicht%20mehr%20Hotfix.zip Hotfix]<br>
 +
<br>
 +
Cause ''".dll"'' files are detected as viruses by default in the browser, you will need to unzip the files and then rename them.<br>
 +
<br>
 +
''libeay32.dll.txt -> libeay32.dll''<br>
 +
''ssleay32.dll.txt -> ssleay32.dll''<br>
 +
<br>
 +
*Now change to Temp directory of the affected system:
 +
*Open Explorer -> type ''%temp%'' in the address bar.
 +
*There should be a folder named ''{BD4F2616-B17D-4982-815F-0C78C476839F}''.
 +
*Please now move the two ''".dll"'' files into the directory.
 +
<br>
 +
 
 +
Afterwards the update should be possible over the already started process.<br>
 
<br />
 
<br />
  
== Keine vollständige Sicherung der SQL Instanz möglich bei Erstsicherung -The database OLAkticom did not have previous successful Full backup ==
+
==== Error 1920 during installation / update of the agent ====
Es kann keine vollständige Sicherung der SQL-Instanz ausgführt werden. Das Log liefert die Fehlermeldung, dass kein vorheriges Vollbackup erstellt wurde, <br>  
+
'''Error:'''<br>
obwohl eine Erstsicherung durchgeführt werden soll und die Sicherungsart auf vollständig mit Transaktionsprotokollen steht. <br>
+
During an installation / update of the Windows Agent, one encounters the following message:<br>
 +
<br>
 +
[[Datei:1920 Fehler.png|border]]<br>
 +
<br>
 +
'''Cause:'''<br>
 +
There are two possible causes for this:<br>
 +
1. required Visual C++ libraries are not available<br>
 +
<br>
 +
2. local port 2548 is blocked by another application<br>
 +
Known applications that cause problems: [https://www.drtax.ch/web/ch/de/index.aspx Dr Tax]<br>
 +
<br>
 +
'''Solution:'''<br>
 +
1. please install the following Visual C++ cumulative update and then run the agent setup again:<br>
 +
<br>
 +
https://support.microsoft.com/en-us/topic/the-latest-supported-visual-c-downloads-2647da03-1eea-4433-9aff-95f26a218cc0<br>
 +
<br>
 +
2.Use the following CMD command to check if the port is blocked via a running process:<br>
 +
<br>
 +
''netstat -ano | findstr 2548''<br>
 +
<br>
 +
''Example: TCP --- 0.0.0.0:2548 --- 0.0.0.0:0 --- LISTEN --- '''5036'''''<br>
 +
<br>
 +
Unless the running process in Task Manager(Details) is then named VVAgent.exe, the port will be blocked.<br>
 +
Subsequently, it must be ensured either temporarily, or better permanently, that the port is open. Once the port is open, the installation / update can be performed successfully.<br>
 +
<br>
  
Bsp Log: <br>
+
=== Windows Agent uninstallation ===
''10-Apr 20:00:32 SQ12-E-09295 The database OLAkticom did not have previous successful Full backup.'' <br>
 
''10-Apr 20:00:32 SQ12-E-09295 The database OLReweAkticom did not have previous successful Full backup.'' <br>
 
''10-Apr 20:00:32 BKUP-E-04706 job will be forced to fail [VV]'' <br>
 
''10-Apr 20:00:32 BKUP-F-04110 job failed to complete [VV]'' <br>
 
''10-Apr 20:00:33 CAT -E-08056 backup aborted [VV]'' <br>
 
''11-Apr 11:47:25 SQ12-E-09295 The database OLAkticom did not have previous successful Full backup.'' <br>
 
''11-Apr 11:47:25 SQ12-E-09295 The database OLReweAkticom did not have previous successful Full backup.'' <br>
 
''11-Apr 11:47:25 BKUP-E-04706 job will be forced to fail [VV]'' <br>
 
''11-Apr 11:47:25 BKUP-F-04110 job failed to complete [VV]'' <br>
 
''11-Apr 11:47:26 CAT -E-08056 backup aborted [VV]'' <br>
 
'''''!! Der MSSQL-VSSWriter Dienst wird unter einen Systemkonto ausgeführt. !!'''''
 
  
'''Lösung:'''
+
==== Error 1722 when uninstalling the Backup Agent ====
Der MSSQL-VSSWriter Dienst muss auf einen ActiveDirectory-Account mit Administrator-Rechten umgestellt werden. <br>
+
'''Error pattern:''' <br>
<br />
+
You will receive the following error message when uninstalling Backup Agent:
 +
[[Datei:Fehler 1722.png|gerahmt|ohne]]
  
== Global Root Backup Fehler ==
+
'''Cause:''' <br>
'''Beispiel:''' <br>
+
The error pattern occurs when agent installation (plug-ins) information is missing from the global.vvc file. Each plug-in adds an entry in this configuration file (e.g. image plug-in). <br>
17-feb 20:58:20 DISK-E-04205 erreur lors de la recherche du fichier GLOBALROOT\Device\HarddiskVolumeShadowCopy10\windows\\systemroot\system32\drivers\vsock.sys <br>
+
The error occurs when during uninstallation the entries in this file do not match the plug-ins stored on the system.
17-feb 20:58:20 DISK-E-04101 message du système d'exploitation : Die Syntax für den Dateinamen, Verzeichnisnamen oder die Datenträgerbezeichnung ist falsch. <br>
 
  
'''Lösung:''' <br>
+
'''Solution:''' <br>
Eine Anpassung des Imagepfades in der Registry ist notwendig -> Computer\HKEY_Local_Machine\System\CurrentControlSet\Services\vsock <br>
+
# Please rename the "global.vvc" inside the installation directory to "global.old". <br>
1. Ändern auf %systemroot%\system32\DRIVERS\vsock.sys <br>
+
# Uninstall the agent afterwards
2. Nach dem Eintrag muss der Server unbedingt neu gestartet werden, um die Einstellungen zu aktivieren. <br>
+
<br />
 +
=== Agent scripting ===
 +
-----
 +
==== PreshutdownTimeout value ====
 +
If you have a Windows Server 2019 machine in use, separate permissions are required to change the following registry key:<br>
 +
<br>
 +
''HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\gpsvc\PreshutdownTimeout''<br>
 +
<br>
 +
Please make sure you can edit the group policies with the users logged in.<br>
 +
<br>
 +
[[Datei:Permissions_gpsvc.png|border|Permissions must be changed]]
 +
<br>
 +
So via "Advanced" please assign permissions to the respective user owner. <br>
 +
<br>
 +
[[Datei:Permissions for gpsvc.png|border]]
 +
<br>
 +
Needed in the case owner permissions. <br>
 +
<br>
 +
[[Datei:Owner Berechtigung.png|border|Owner]]
 +
<br>
 +
After that, you should be able to adjust Registry Key accordingly.<br>
 
<br />
 
<br />
  
== Umlaufprotokollierung Exchange ==
+
=== Windows Agent file-based backup ===
Falls die Umlaufprotokollierung aktiviert ist, erhaltne Sie eine entsprechende Fehlermeldung Die Umlaufprotokollierung sollte in Produktivumgebungen besser deaktiviert werden. <br>
+
-----
„Umlaufprotokollierung wird für Produktionsumgebungen nicht empfohlen." <br>
+
==== Analysis point in the following path is not traversed ====
Quelle: https://technet.microsoft.com/de-de/library/bb331968%28v=exchg.80%29.aspx <br>
+
The error message says that you are trying to save a path that is some sort of link. <br>
Im o.g. Link wird auch beschrieben, wie man die Umlaufprotokollierung auf einem Exchangeserver deaktiviert.  <br>
+
The actual dataset will probably be on another partition. <br>
Ein informativer Artikel zum Thema Umlaufprotokollierung: <br>
+
This directory was apparently not included in the backup, so the agent does not backup this as well. <br>
http://www.itadministrator.de/themen/kommunikation/123111.html <br>
 
Alternativ können Sie auch die Sicherung der Transaktionsprotokolle deaktivieren. Dann wird nur die Exchange-Datenbank gesichert, Transaktionsprotokolle werden außen vorgelassen. <br>
 
 
<br />
 
<br />
  
== SMPT Prober / Mailbenachrichtigung ==
+
==== Linked hard links were not selected and were not saved ====
Bitte prüfen Sie einmal mittels SMTP Prober Tool ob die Mails generell von dem System aus versendet werden können: <br>
+
'''Error pattern:'''<br>
http://www.alexnolan.net/software/SMTPProber.htm <br>
+
The backup job completes with warnings "Linked hardlinks were not selected and were not backed up". This warning looks like the following in the log file:
Sofern Sie mit dem Tool erfolgreich Emails von dem System versenden können ist sichergestellt, dass die Kommunikation mit dem Mailserver aufgebaut werden kann. <br>
+
[[Datei:Hardlinks.png|none]]
<br />
+
 
 +
'''Cause of error:'''<br>
 +
Hardlinks are files or directories that reference an existing entry in the Master File Table and have the identical properties and contents as the original file.
 +
Original file and hardlink differ only in the path.
 +
The Configured Backup Set does not include all the hardlinks that exist for the original file and therefore cannot be backed up.  
 +
 
 +
'''Possible solutions:''' <br>
 +
# Once the entire NTFS partition is backed up, no more linked hardlinks can be faulted.<br>
 +
# The backup set can be extended with all existing hardlinks, the required paths can be read out via the command below using PowerShell or CMD.
 +
Syntax : fsutil hardlink list <filename>
 +
Example : fsutil hardlink list c:\list.txt
 +
 
 +
==== OneDrive directory cannot be backed up ====
  
== Bu Agent Protokoll Datei wurde nicht gefunden ==
+
'''Error pattern:''' <br>
'''Ursachen:''' <br>
+
A file-based backup job reports the following error in the logfile:<br>
Sollte die Kommunikation einwandfrei funktionieren (ping backup.terracloud.de && telnet backup.terracloud.de 8086), kann ein Sonderzeichen im Passwort des Portal-Benutzers der Grund sein. <br>
+
''DISK-E-04205 Error searching for file C:\Users\%USER%\OneDrive\*.*''<br>
<br />
+
''DISK-E-04101 Operating system message: The medium is write-protected.''<br>''
'''Lösung:''' <br>
 
Vermutlich verwenden Sie bei der Registrierung gegenüber dem Portalserver einen selbsterstellten Benutzer den Sie in der Subsite angelegt haben. <br>
 
Kann es sein, dass Sie hier einen Umlaut beim Passwort nutzen? <br>
 
Ändern Sie testweise mal das Passwort z.B. auf "Terra001!" (ohne "") und versuchen Sie erneut den Agent gegenüber dem Portalserver zu registrieren. <br>
 
Wenn das klappt, dann nennen Sie uns bitte den Umlaut den Sie verwenden (wenn möglich auch gerne das komplette Passwort). Anscheinend hat unser Agent mit manchen Sonderzeichen Probleme. <br>
 
<br />
 
  
== Granular Restore Tool - Lizenz ==
+
'''Solution:''' <br>
Während der Installation des Granular Restore Tools werden Sie nach einer Lizenz gefragt.<br>
+
A setting within OneDrive ensures that the agent only sees links to files, as these are only downloaded when needed. <br>
 +
These 0KB files cause the error message, the files must be downloaded once, so that there are no more Verknpüfungen.<br>
 +
In addition, please uncheck the "Files on demand" checkbox, as shown in this screenshot:<br>
 
<br>
 
<br>
Bitte senden Sie uns eine E-Mail inklusive Ihrer Kundennummer mit dem Betreff "Granular Restore Lizenz" an support@terracloud.de <br>
+
[[Datei:One-drive.png|border|One-Drive]]
Wir werden Ihnen dann eine entsprechende Lizenz zur Verfügung stellen.<br>
+
 
 +
==== SV -W-08372 Exclusion <''Exclusion in backup job''> is suppressed because it interferes with <''Component of BMR backup''> BMR selection ====
 +
'''Error pattern:'''<br>
 +
You receive the following error message in the log file of a file-based backup job: <br>
 +
''SV -W-08372 exclusion <exclusion in backup job> is suppressed because it affects <component of BMR backup> BMR selection.''
 +
 
 +
'''Cause:'''<br>
 +
The configured exclusion would exclude files that are necessary for BMR backup.
 +
The backup agent ignores the exclusion to perform a BMR backup.
 +
 
 +
'''Recommended Action:'''<br>
 +
Please remove the offending exclusion from the affected backup job, otherwise the job will complete with a warning for each backup.
 +
Modify the exclusion, if needed, to exclude no system-relevant files.
 +
 
 +
==== Outlook Offline Data File (OST) ====
 +
*.ost files are offline Outlook data files which are automatically created by IMAP accounts, Microsoft 365 accounts, Exchange accounts and Outlook.com accounts. <br>
 +
Since they cannot be moved from one computer to another, there is no need to back them up.
 +
 
 +
The following registry key excludes *.ost files from the creation of a VSS snapshot by default: <br>
 +
''Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\BackupRestore\FilesNotToSnapshot''
 +
 
 +
[[Datei:Ost-Dateien.jpg|gerahmt|ohne]]
 +
 
 +
'''Why should *.ost files be excluded from the backup?: <br>'''
 +
https://social.technet.microsoft.com/Forums/en-US/fc9bebff-9494-4b45-b43d-6b2f8e98add4/oops-windows-7-backup-omits-key-outlook-mail-files <br>
 +
[https://support.office.com/en-us/article/find-and-transfer-outlook-data-files-from-one-computer-to-another-0996ece3-57c6-49bc-977b-0d1892e2aacc?ui=en-US&rs=en-US&ad=US#ID0EAACAAA=Office_2007_-_2010 https://support.office.com/en-us/article/find-and-transfer-outlook-data-files-from-one-computer-to-another]
 +
 
 +
'''More information about files that are automatically excluded from a backup by the operating system:'''<br>
 +
https://docs.microsoft.com/en-us/windows/win32/vss/excluding-files-from-shadow-copies
 +
 
 +
 
 +
<span style="color:red">It is not recommended to make any changes to the mentioned registry keys.</span>.
 +
 
 
<br />
 
<br />
  
== Agentupgrade ==
+
==== DISK-E-08235 Operating system error 225, message: The operation could not be completed successfully because the file contains a virus or possibly unwanted software ====
Bei einer Installation eines Agents ab v8 kann das Upgrade direkt durchgeführt werden. <br>
+
 
Alternativ verwenden Sie die folgende Anleitung:<br>
+
'''Error pattern:''' <br>
Bitte deinstallieren Sie den alten Agent(nur Programmdaten) und installieren die neue Version. (Es können Neustarts erforderlich sein) <br>
+
You receive the following error message in a file-based backup job log file:<br>
Danach gehen Sie wie folgt vor:   <br>
+
 
- Im Backupportal unter "Vault-Einstellungen" bitte "Erneut registrieren" <br>  
+
''DISK-E-08235 Operating system error 225, message: The operation could not be completed successfully because the file contains a virus or possibly unwanted software.''<br>
- Danach können Sie die Vault Einstellungen laden und unten rechts das System wieder auswählen <br>
+
 
- Nach einigen Sekunden oder einem Refresh der Seite sollten Ihnen die Computer und Jobs wieder angezeigt werden  <br>
+
'''Cause:''' <br>
- Jeweils die Jobs bearbeiten und das Verschlüsslungskennwort eingeben (dieses kann nicht rekonstruiert werden, da das Job-Passwort auf dem Vault nicht gespeichert wird) <br>
+
This is a message from the operating system to the agent. Windows Defender is responsible for checking the file.<br>
- Jeweils die Jobs synchronisieren, dadurch werden die Delta-Dateien auf dem Agenten neu erstellt <br>
+
 
- Nun bitte nochmal eine Sicherung starten <br>
+
'''Recommended Action:''' <br>
 +
Please check the complained file, in case it is a false report message from Windows Defender, you can release it via whitelist.<br>
 +
Optionally, you can use another antivirus solution to scan the file.<br>
 +
 
 +
==== DISK-E-08235 Operating system error 1392, message: The file or directory is corrupted and unreadable ====
 +
'''Error pattern:''' <br>
 +
You will receive the following error message in the log file:
 +
 
 +
''DISK-E-08235 Operating system error 1392, message: The file or directory is corrupted and unreadable''
 +
 
 +
'''Cause:''' <br>
 +
The Backup Agent passes on an error message from the operating system that the offending file is corrupted or unreadable.
 +
 
 +
'''Recommended Action:''' <br>
 +
Please check the corresponding file, because this error message is not caused by the backup software. <br>
 +
A system scan via sfc/scannow may resolve the error pattern. <br>
 +
Diagnosis via CHKDSK may also be helpful in this case. <br>
 +
 
 +
==== Disable security data processing due to insufficient authorization ====
 +
 
 +
'''Error pattern:'''<br>
 +
 
 +
You will receive the following warning message in the log file:
 +
 
 +
''DISK-W-08623 Disable security data processing due to insufficient authorization''
 +
 
 +
'''Cause:'''<br>
 +
Compress Advanced Attributes (compress content to save disk space) enabled for at least one directory.
 +
 
 +
[[Datei:Erweiterte Attribute.png|gerahmt|ohne]]
 +
 
 +
'''Solution:'''<br>
 +
To locate these directories you can run the job once with a different log level.
 +
Please edit your job and select the option "Directory" as "Options for log file:". Afterwards, run the backup again, now you should find below the line shown below hints to the directories that cause this.  
 +
This form of logging generates large log files therefore this type should only be used temporarily.
 +
Locate these folders and in Properties->Advanced remove the item "Compress content to save disk space".
 +
Afterwards, both TERRA CLOUD backup services should be restarted.
 +
 
 +
==== DISK-E-04144 Error opening file [...] $Exported$BCD for input ====
 +
 
 +
'''Error pattern:''' <br>
 +
You will receive the following warning message in the log file:
 +
 
 +
''DISK-E-04144 Error opening file \GLOBALROOT\Device\HarddiskVolume2\EFI\Microsoft\Boot\$Exported$BCD for input'' <br>
 +
''DISK-E-08235 Operating system error 32, message: Process cannot access the file because it is being used by another process'' <br>
 +
''DISK-E-04144 Error opening file \GLOBALROOT\Device\HarddiskVolume2\EFI\Microsoft\Boot\$Exported$BCD.LOG for input'' <br>
 +
''DISK-E-08235 Operating system error 32, message: Process cannot access the file because it is being used by another process'' <br>
 +
 
 +
'''Cause:''' <br>
 +
This error pattern is caused by various antivirus software based on Bitdefender. The module "Behavioral scan" in version 6.6.18.265 is responsible.
 +
 
 +
'''Solution:''' <br>
 +
Please update your antivirus software, as this error pattern has been fixed in an update.
 +
 
 +
==== UTIL-E-04101 O/S message: The request could not be executed due to an I/O device error ====
 +
 
 +
'''Error pattern:'''<br>
 +
You will receive the following warning message in the log file: <br>
 +
''UTIL-E-04101 O/S message: The request could not be executed due to an I/O device error''.
 +
 
 +
'''Cause:''' <br>
 +
The Backup Agent passes on this error message of the operating system in the log file.
 +
You can also find this error message in the system event logs under ID 153.
 +
This is not a problem with the backup solution.
 +
 
 +
'''Recommended Action:''' <br>
 +
Please check the following [https://docs.microsoft.com/en-us/archive/blogs/ntdebugging/interpreting-event-153-errors Microsoft contribution] for this ID.
 +
 
 +
 
 +
As described in the Microsoft post, this is a timeout of a request to the storage.
 +
For further troubleshooting we recommend the CHDSK tool, for more information see:
 +
[https://docs.microsoft.com/de-de/windows-server/administration/windows-commands/chkdsk Microsoft post chdsk]
 +
 
 +
==== ENVC-E-04096 GetProcessorInfo FindFirstObject failed ====
 +
'''Error pattern:''' <br>
 +
You receive the following error message in the log file of a file-based backup job:
 +
 
 +
''ENVC-E-04096 GetProcessorInfo FindFirstObject failed'' <br>
 +
''ENVC-E-04096 GetBootConfiguration FindFirstObject failed'' <br>
 +
''ENVC-E-04096 GetComputerSystem FindFirstObject failed'' <br>
 +
''ENVC-E-04096 GetOSInfo FindFirstObject failed'' <br>
 +
''ENVC-E-04096 CaptureSystemRestorePointInfo Env Exception: Failed to obtain EnvInfo''<br>
 +
''BMR -E-08382 BMRCaptureEnvInfo.dll could not be initialized: BMR::CaptureEnvInfoDLL::captureSystemRestorePointInfo(): BMRCaptureEnvInfo.dll DLL failed to capture System Restore Point Info'' <br>
 +
 
 +
'''Cause:''' <br>
 +
The backup agent cannot retrieve any information of the system (e.g. version of the operating system) via the WMI interface. This error pattern is '''not''' caused by the TERRA CLOUD Backup Agent.
 +
It may be that the required files are still being accessed by other programs and therefore the information cannot be read.
 +
 
 +
'''Recommended Action:'''<br>
 +
Please check the following query via PowerShell as an example: <br>
 +
''Get-WmiObject Win32_Processor''
 +
 
 +
If no output is possible here either, we recommend that you check the Windows Event Logs at this time.
 +
 
 +
==== DISK-W-08623 - Disable security data processing due to insufficient authorization ====
 +
 
 +
<p style="color: #FF0000;">
 +
 
 +
This article was written for the job type "UNC files". For the job type "Local system" there is the following [https://wiki.terracloud.de/index.php/Backup_Troubleshooting#Disable_security_data_processing_due_to_insufficient_authorization article]<br>
 +
 
 +
</p>
 +
'''Error pattern:''' <br>
 +
You receive the following warning message in the log file of a UNC job: <br>
 +
 
 +
DISK-W-08623 Disable security data processing due to insufficient authorization
 +
 
 +
'''Cause:'''<br>
 +
The NAS is not allowing the ACLs to be backed up.
 +
 
 +
'''Recommended Action:'''<br>
 +
Please go to the agent system and open the job configuration:<br>
 +
C:\Program Files\TERRA Cloud Backup\Agent\<JOBNAME>.vvc"<br>
 +
Here you will find the Ignore_Security and Ignore_AltData entries:<br>
 +
 
 +
Ignore_Security: this switch determines whether the ACLs should be backed up or not. The NAS (e.g. QNAP) does not allow the ACLs to be backed up, so you must set the switch to TRUE.<br>
 +
 
 +
Ignore_AltData: This switch determines whether the extended attributes should be backed up or not.
 +
Provided the Ignore_Security option is set to TRUE, or MAC files are backed up via the job, you should set the switch to TRUE.<br>
 +
   
 +
Afterwards, both TERRA Cloud Backup services should be restarted.<br>
 +
 
 +
If the backup job is no longer displayed in the portal after this adjustment, additional characters were probably stored in the configuration file.
 +
In this case, please check the <JOBNAME>.vvc with an editor that can display all characters, e.g. Notepad++ (show non-printable characters).<br>
 +
 
 +
After you have set the options and a backup has been made, be sure to do a test restore.<br>
 +
Since backing up MAC files is not officially supported by our solution, we cannot 100% guarantee that the files can be restored without any problems.<br>
 
<br />
 
<br />
  
== Erneut registrieren ==
+
=== Windows Agent Image Backup ===
Wenn zum Beispiel ein Job aus dem Portal gelöscht wurde, muss eine erneute Registrierung des Servers am Vault stattfinden.
+
-----
Dazu müssen Sie wie folgt vorgehen:<br>
+
==== deactivate CBT (Changed Block Tracking)====
 +
 
 +
'''Instructions:''' <br>
 +
#Stop the two services of TERRA CLOUD Backup Agent.  
 +
#Please navigate to the installation directory of TERRA CLOUD Backup Agent (default installation path: ''C:\Program Files\TERRA Cloud Backup\Agent'').
 +
#Open the file ''NameOfTheBackupJob.vvc''
 +
#Add a new switch as described below
 +
#Save the file including the changes
 +
#Start the two services of TERRA CLOUD Backup Agent
 +
 
 +
'''Step 7:''' <br>
 +
Take a look for the following section in the opened configuration file:
 +
 
 +
<code>VolumeImageBackup { <br>
 +
SQLServer_Awareness = False <br>
 +
} </code> <br>
 +
 
 +
Add the following parameter:
  
Bitte löschen Sie die vorhandenen Jobs und den Vault für diesen Computer aus dem Portal. <br>
+
<code>VolumeImageBackup { <br>
Ihre Daten sind von der Löschung nicht betroffen. Danach gehen Sie wie folgt vor:  <br>
+
SQLServer_Awareness = False <br>
1. Bitte wählen Sie im Backupportal Sie unter "Vault-Einstellungen", "Erneut registrieren" aus.  <br>
+
EnableCBT = False <br>
2. Laden Sie die Vault Einstellungen. Das gewünschte System finden Sie unten recht im aktuellen Fenster.  <br>
+
} </code> <br>
3. Nach einigen Sekunden sollten Ihnen die Computer und Jobs wieder angezeigt werden. Ggf. müssen Sie sich erneut einloggen. <br>
+
   
4. Bearbeiten Sie die vorhandenen Jobs und tragen Sie jeweils das Verschlüsslungskennwort ein und führen Sie eine Synchronisation durch.  <br>
+
'''Effects of this adjustment'''<br>
5. Im letzten Schritt starten Sie bitte die Sicherung manuell. <br>
+
By this configuration adjustment the delta detection via the Changed Block Tracking technology is switched off You get a warning in the logfile regarding the adjustment:<br>
 +
is disabled in the configuration file. The entire volume is read for backup. The complete volume read process increases the backup time.<br>
 
<br />
 
<br />
  
== Löschung von Daten auf einem Vault ==
+
==== VIMG-W-09841 - CBT (Changed Block Tracking) is not available ====
 +
'''Error message:''' <br>
 +
You will receive the following warning message in the log file:
 +
 
 +
''VIMG-W-09841 CBT (Changed Block Tracking) is not available.''
  
Falls Sie einen Job oder Server aus dem Backupportal löschen, verbleiben die Daten aus Sicherheitsgründen weiterhin auf dem Vault.
+
'''Cause:''' <br>
Um die Daten endgültig zu entfernen, benötigen wir einen expliziten Löschauftrag. Dieser muss die folgenden Informationen enthalten: <br>
+
The installation of the CBT driver (Changed Block Tracking) requires a reboot, this was not performed at the time of the backup. <br>
- Accountname <br>
+
 
- Servername <br>
+
'''Note:''' <br>
- Ggf. Jobname <br>
+
Backing up a system via an image backup job is also possible without the Changed Block Tracking, but the backup duration is much longer. <br>
- Ggf. Safesets <br>
+
 
 +
'''Solution:''' <br>
 +
Please perform a system reboot to be able to use the full functionality of the image plug-in. <br>
 
<br />
 
<br />
  
== Offline-Computer aus dem Portal löschen ==
+
==== VIMG-W-09829 - The changed block logging driver fails to log the changes for volume <X>:<volume{XY}>. (State 0, Status 0)====
Ein System kann aus dem Backup Portal entfernt werden sofern dieses als „offline“ gekennzeichnet wird.  <br>
+
 
Setzen Sie in der Zeile des Systems in der ersten Spalte den Haken und gehen auf „Aktion auswählen“ -> „Ausgewählten Computer entfernen/löschen“. <br>
+
'''Error message:''' <br>
 +
You will receive the following warning message in the log file:
 +
 
 +
''VIMG-W-09829 The changed block logging driver fails to log the changes for volume <X>:<volume{XY}>. (State 0, Status 0)''
 +
 
 +
'''Cause:''' <br>
 +
The installation of the CBT driver (Changed Block Tracking) requires a reboot, this was not performed at the time of the backup. <br>
 +
 
 +
'''Note:''' <br>
 +
Backing up a system via an image backup job is also possible without the change block tracking, but the backup duration is much longer. <br>
 +
 
 +
'''Solution:''' <br>
 +
Please perform a system reboot to be able to use the full functionality of the image plug-in. <br>
 
<br />
 
<br />
  
== Richtlinien ==
+
==== PLGN-E-05905 Could not load <VolumeImagePlugin.dll> ====
Die Richtlinien lassen sich derzeit nur auf der Ebene der Site und nicht übergreifend anwenden. <br>
+
'''Error message:'''<br>
Das heißt Sie müssten sich einmal als Benutzer der jeweiligen Subsite einloggen und die Richtlinien dort anwenden. <br>
+
You will receive the following error message in the log file.
Bitte beachten Sie, dass der Benutzer Administrationsrechte benötigt. <br>
+
''PLGN-E-05905 Could not load <VolumeImagePlugin.dll>''<br>
 +
''DISK-E-04793 Drive $VOLUMEIMAGE$:\ is not recognized as a persistent mapped drive (drive not found)''.<br>
 +
''DISK-E-04204 Error assigning channel to $VOLUMEIMAGE$:\*.*''<br>
 +
<br>
 +
'''Cause:'''<br>
 +
The backup solution is not able to use the image plugin. Often due to the following causes:<br>
 +
*The image plugin was forgotten to install after a new installation / re-registration.<br>
 +
*The image plugin / agent is corrupted.<br>
 +
<br>
 +
'''Solution:'''<br>
 +
By running the agent setup again, you have the option to perform a change installation. Here you can post-install the image plugin.<br>
 +
Please note that a reboot should take place after the installation of the image plugin.<br>
 +
By re-running the agent setup, you also have the option to perform a repair installation of the agent.
 
<br />
 
<br />
  
== Verbindungsprobleme ==
+
==== VIMG-E-0449 Volumeimage_plugin::VolumeImageBackupAdapter::getNextBackupObject failed ====
Ohne weitere Fehlermeldungen folgendes -> <br>
+
'''Error message:'''<br>
''15.dic. 22:30:17 SSET-W-05072 Es konnte keine Verbindung zum Vault-Dienst hergestellt werden (Vault:vault-wmh1-0XXX.terracloud.de, Ports:2546)'' <br>
+
01.ago. 07:18:47 VIMG-E-07966 Job cannot be continued.<br>
''15.dic. 22:30:17 RSYN-W-07715 Verbindung mit oder Aushandeln der Sicherung mit registriertem Vault fehlgeschlagen. [VV]'' <br>
+
01.ago. 07:18:59 VIMG-E-04495 volumeimage_plugin::VolumeImageBackupAdapter::getNextBackupObject failed.<br>
'''Lösung:''' <br>
+
01.ago. 07:18:59 BSTR-E-04144 Error opening file C:\Program Files\TERRA Cloud Backup\Agent\*<br>
Bitte nutzen Sie testweise einmal einen anderen DNS Server. Wie im Logfile ersichtlich wird die Verbindung einige Sekunden später aufgebaut. <br>
+
01.ago 07:18:59 BKUP-E-04706 Job is forced to fail. [VV]<br>
Wir konnten ein solches Verhalten bislang beobachten sofern der DNS Server zeitlich verzögert reagiert. <br>
+
01.ago. 07:18:59 BKUP-F-04110 Job could not be completed. [VV]<br>
 +
<br>
 +
'''Cause:'''<br>
 +
The Microsoft VSS service cannot put the system in a consistent state.
 +
There are many possible causes e.g.:
 +
# On the system to be backed up the "Microsoft Hyper-V VSS Writer" is stored, please note that a BMR backup on Hyper-V hosts is not supported
 +
# VSS Writer from third party software are deposited on the system
 +
# A path to an .exe file in the registry points to a network share, please note that the VSS service cannot access network shares
 +
 
 +
<br>
 +
'''Recommendation for action:'''<br>
 +
Please check the deposited VSS Writers via the command "vssadmin list Writers" and compare them with a system on which an image-based BMR backup is possible.
 +
 
 +
In addition, we recommend that you read out the details of the VSS Writer and check for a stored network share.
 +
The following article describes how to read the details of the Writer: <br>
 +
[[Backup_Troubleshooting#Details_of_Microsoft_VSS_Writer_readout|Microsoft VSS Writer details readout]]
 
<br />
 
<br />
  
== Prüfung der Ports ==
+
==== Error while collecting information about the system provisioning point ====
Mithilfe des folgenden Scriptes können Sie im Powershell(ISE) prüfen, ob Sie die benötigten Ports freigeschaltet haben: <br>
+
'''Error pattern:''' <br>
''1 .. 4 | ForEach-Object { Write-Host "amp$(($_).ToString("00")).terracloud.de" : $(Test-NetConnection "amp$(($_).ToString("00")).terracloud.de" -Port 8087).TcpTestSucceeded }<br>
+
You get the following or similar error image in the log file:
Test-NetConnection backup.terracloud.de -Port 8086''
+
 
<br />
+
''BKUP-E-08235 Operating system error 2, message: The system cannot find the specified file'' <br>
 +
''BKUP-W-08732 Mount point information for system could not be captured. [VV]''<br>
 +
''BKUP-E-09401 An error occurred while collecting system mount point information. [VV]'' <br>
 +
''BKUP-E-08235 O/S error 2, message: The system cannot find the specified file'' <br>
 +
''BKUP-W-08732 Failed to collect system mount point information [VV]'' <br>
  
== Analysepunkt in folgendem Pfad wird nicht traversiert ==
+
'''Recommended Action:'''<br>
Die Fehlermeldung besagt, dass Sie einen Pfad versuchen zu sichern der eine Art Verlinkung darstellt. <br>
+
Please run the following command on the affected system:<br>
Der eigentliche Datenbestand wird sich vermutlich auf einer anderen Partition befinden.  <br>
+
''Mountvol /r''<br>
Dieses Verzeichnis wurde offenbar nicht in die Sicherung inkludiert, der Agent sichert dies also nicht mit. <br>
+
(Removes volume mount point directories and registry settings for volumes that are no longer on the system, preventing them from being automatically mounted and retaining their previous volume mount points when they are added back to the system)<br>
 +
<br>
 +
Rebooting the system may also be helpful.<br>
 
<br />
 
<br />
  
== BMRCaptureEnvInfo.dll konnte nicht initialisiert werden: BMR::CaptureEnvInfoDLL::captureSystemRestorePointInfo(): BMRCaptureEnvInfo.dll DLL failed to Capture System Restore Point Info ==
+
=== Windows Agent SQL Backup ===
'''Problem:''' <br>
+
-----  
BMR Backups schlagen mit folgendem Fehler fehl: <br>
+
==== SQL Express DB backup via SQL plugin fails ====
11-Jun 13:19:21 ENVC-E-04096 GetProcessorInfo FindFirstObject failed <br>
+
'''Error pattern:'''<br>
11-Jun 13:19:21 ENVC-E-04096 GetBootConfiguration FindFirstObject failed <br>
+
06.ago. 14:08:25 DISK-E-04144 Error opening file \GLOBALROOT\Device\HarddiskVolumeShadowCopy217\Programs\Microsoft SQL Server\MSSQL10_50._SQLEXPRESS\MSSQL\DATA\SQLEXPRESS\%DB%.mdf for input
11-Jun 13:19:21 ENVC-E-04096 GetComputerSystem FindFirstObject failed <br>
 
11-Jun 13:19:21 ENVC-E-04096 GetOSInfo FindFirstObject failed <br>
 
11-Jun 13:19:21 ENVC-E-04096 CaptureSystemRestorePointInfo Env Exception: Failed to obtain EnvInfo <br>
 
11-Jun 13:19:21 BMR -E-08382 Failed to initialize BMRCaptureEnvInfo.dll: BMR::CaptureEnvInfoDLL::captureSystemRestorePointInfo(): BMRCaptureEnvInfo.dll DLL failed to Capture System Restore Point Info <br>
 
11-Jun 13:19:22 BKUP-F-04110 job failed to complete [VV] <br>
 
'''Ursache:''' <br>
 
Dies ist ein Problem mit WMI-Korruption auf dem Computer und wird nicht durch den Agenten verursacht. <br>
 
Es kann dadurch verursacht werden, dass andere Anwendungen die Eigentümerschaft an Dateien übernehmen, die der Agent zum Betrieb benötigt. <br>
 
'''Lösung:''' <br>
 
Führen Sie mit erweiterten Benutzerrechten folgendem Befehl in der Eingabeaufforderung aus: <br>
 
secedit /configure /cfg %windir%\inf\defltbase.inf /db defltbase.sdb /verbose <br>
 
Neustart des Servers, Überprüfung auf die Möglichkeit, WMI Management Interface in Computer Management, WMI Controls Properties zu öffnen <br>
 
Wenn es immer noch nicht funktioniert, dann:  <br>
 
 
<br>
 
<br>
Erstellen Sie ein Batch-Skript in C:\Windows\System32\WBEM <br>
+
06.ago. 14:08:25 VSS -E-08102 File backup error (reason: stream backup error) C:_Programs\Microsoft SQL Server\MSSQL10_50._SQLEXPRESS\MSSQL\DATA\SQLEXPRESS\%DB%.mdf component <writer SqlServerWriter (SQL Server 2008 R2:SQLWriter), component %SERVERNAME%\ SQLEXPRESS\ SQLEXPRESS> fails.
''@echo off'' <br>
 
''sc config winmgmt start= disabled'' <br>
 
''net stop winmgmt /y'' <br>
 
''%systemdrive%'' <br>
 
''cd %windir%\system32\wbem'' <br>
 
''for /f %%s in ('dir /b *.dll') do regsvr32 /s % wmiprvse /regserver winmgmt /regserver sc config winmgmt start= auto net start winmgmt for /f %%s in ('dir /s /b *.mof *.mfl') do mofcomp %%s'' <br>
 
 
<br>
 
<br>
Ausführen von einer erhöhten Eingabeaufforderung, anschließend neustarten. <br>
+
06.ago. 14:08:25 CTLG-W-09909 Incomplete backup set metadata. Information for "plugin-specific" could not be retrieved
 +
 
 +
'''Cause:'''<br>
 +
SQL Express instances can only be backed up with the SQL Plug-in as of agent version 8.71. An overview of the supported SQL versions can be found in the release notes. <br>
 +
https://drive.terracloud.de/dl/fiLpZboTGRPeqzW1cqwS6yin/Documentation_and_Release_Notes.zip
 +
 
 +
'''Solution:'''<br>
 +
Please update the agent version to 8.71 or higher.<br>
 
<br />
 
<br />
  
== DISK-W-08623 Sicherheitsdatenverarbeitung aufgrund unzureichender Berechtigung deaktivieren  [VV] - UNC Jobs ==
+
==== SQ12-E-09295 A successful full backup has not yet been made of database XY.====
Sofern Sie Dateien mittels UNC Freigabe von einem NAS sichern können Sie wie folgt vorgehen: <br>
+
'''Error pattern:''' <br>
Bitte gehen Sie auf das Agentensystem und öffnen die Jobkonfiguration: ''C:\Program Files\TERRA Cloud Backup\Agent\<JOBNAME>.vvc'' <br>
+
You receive an error message in the log file that no successful backup could be created from a database:
Hier finden Sie den Eintrag Ignore_Security. <br>
+
 
Dieser Schalter legt fest, ob auch die ACLs gesichert werden sollen oder nicht. QNAP beispielsweise erlaubt so die Sicherung der ACLs über diesen Weg nicht. Von daher sollte der Schalter auf TRUE gesetzt werden.  <br>
+
''SQ12-E-09295 A successful full backup has not yet been made of the database '''database name'''.''
Anschließend sollten die beiden terra CLOUD Backup Dienste neugestartet werden. <br>
+
 
 +
'''Cause:''' <br>
 +
 
 +
The MSSQL VSSWriter service runs under a system account.
 +
 
 +
'''Recommendations for action:'''
 +
 
 +
*The MSSQL VSSWriter service should be changed to an ActiveDirectory account with administrator privileges. <br>
 +
 
 
<br />
 
<br />
  
== DISK-W-08623 Sicherheitsdatenverarbeitung aufgrund unzureichender Berechtigung deaktivieren  [VV] - Lokale Jobs ==
+
==== SQL Backup Jobs cannot be edited after credentials change ====
Die Fehlermeldung deutet darauf hin, dass für einige Verzeichnisse auf Ihrem System die Eigenschaft „Compress Advanced Attribute" aktiviert ist.  <br>
+
'''Solution:''' <br>
Um diese Verzeichnisse zu lokalisieren können Sie den Job einmal mit einem anderem Log-Level ausführen.  <br>
+
Make a backup copy before changing the files! <br>
Bitte bearbeiten Sie hierzu Ihren Job und wählen als „Optionen für Protokolldatei:" die Option „Directory" aus. <br>
+
1. create a new SQL job with the new Windows credentials. <br>
Führen Sie im Anschluss das Backup erneut aus, nun sollten Sie unterhalb der unten aufgezeigten Zeile Hinweise auf die Verzeichnisse finden die diese verursachen. <br>
+
2. you will find the file "JOBNAME.vvc" <br> in the installation directory of the agent.
Lokalisieren Sie diese Ordner und entfernen Sie in den Eigenschaften->Erweitert den Punkt „Inhalt komprimieren, um Speicherplatz zu sparen". <br>
+
3. copy the paragraph "WindowsCredentials" from your test job to the .vvc of the correct backup job <br>
Diese Form der Protokollierung kann u.a. große Logfiles erzeugen daher sollte dieser Typ nur temporär genutzt werden. Anschließend sollten die beiden terra CLOUD Backup Dienste neugestartet werden <br>
+
 
 +
Subsequently, the backup process could be continued. <br>
 
<br />
 
<br />
  
== Fehler letzte Zugriffszeit konnte nicht zurückgesetzt werden ==
+
==== No instance list could be provided by the agent ====
1. Bearbeiten Sie die job.vvc <br>
+
'''Error pattern:'''<br>
2. Fügen Sie diese Zeile zur Backup{ } section hinzu: ''Last_Access_Time_Fix = False'' <br>
+
You get the error message on the following screenshot when you try to create a new SQL backup job via Backup Portal:
<br />
+
[[Datei:Instanzliste-SQL.jpg|border|ohne]]
 +
'''Cause:'''<br>
 +
The agent cannot connect to the SQL instance.
 +
Possible causes are: <br>
 +
# There is no SQL instance installed on the system
 +
The installed SQL instance is not supported by the SQL plug-in, e.g. because it is not a Microsoft SQL instance.
 +
'''Recommended Action:'''<br>
 +
Please check the latest [https://drive.terracloud.de/dl/fiGSGAKpTRTshcP4GyMrGcDD/Release%20Notes Release Notes] for the Windows Agent to see if the installed instance is supported.
 +
 
 +
==== You are shown the databases of a named instance, although you have selected "Standard" as instance ====
 +
'''Error pattern:'''<br>
 +
When setting up a new SQL backup job, or editing an existing job, you are not shown the databases of the MSSQL instance.
 +
Additionally, you may not be able to log in with the SQL credentials of the user of the MSSQL instance, even though you have selected the default instance.
 +
 
 +
'''Cause:'''<br>
 +
If you select Standard as the instance in the Backup Portal, the instance for which the port '''1433''' is assigned is checked in the background.
 +
If this port is assigned to another instance, this instance will be displayed or you will be asked to authenticate for it.
 +
 
 +
'''Solution option 1:'''<br>
 +
If possible, reassign port 1433 to the default instance.
 +
 
 +
To do this, open the SQL Server Configuration Manager
 +
#Select the menu item SQL Server Network Configuration -> Protocols for MSSQLSERVER -> TCP/IP -> IPALL
 +
Port 1433 should be set for this option, as shown in the following screenshot
 +
 
 +
[[Datei:Port 1433.jpg|border|ohne|700px]]
 +
'''Solution option 2:'''<br>
 +
If solution option 1 is not possible, we recommend that you implement the following steps:<br>
 +
 
 +
Please check the Connection String first:<br>
 +
1.open Notepad<br>
 +
2.Please add the following 3 line to the text file. <hostname> stands for the hostname of your SQL server;<port_number> is the assigned port of the default instance<br>
 +
      ''set db = CreateObject("ADODB.Connection")'' <br>
 +
      ''db.open "Driver={SQL Server};Server=<hostname>,<port_number>;Database=;"''<br>
 +
      ''MsgBox(db.Provider)''<br>
 +
3.save the text file as e.g. "test_db.vbs". <br>
 +
4.run the created script <br>
 +
 
 +
After verifying the connection, please make the following adjustment in the SQL server registry: <br>
 +
1.open the registry <br>
 +
2.Navigate to "HKEY_LOCAL_MACHINE\SOFTWARE\EVault\InfoStage\Agent\" <br>
 +
3.create the entry "ADOConnectionStrings" as "REG MULTI SZ" add <br>
 +
4.add the following key to the created entry<br>
 +
 
 +
      ''<hostname>="Driver={SQL Server};Server=<hostname>,<port_number>;Database=;"'' <br>
  
== Synchronisation/DTX DTA/lokales Delta ==
+
An example would be:
In diesem Fall müssen die Deltadateien komplett ersetzt werden. Hierzu finden Sie in dem folgenden Ordner "C:\Programme\Terra Cloud Backup\Agent\$JOBNAME$\" Dateien mit der Endung .DTA und .DTX.  <br>
+
''"SQL01="Driver={SQL Server};Server=SQL01,1434;Database=;"''
Bitte nennen Sie die beiden aktuellsten Dateien davon um und starten Sie erneut die Synchronisation.  <br>
+
In this example, SQL01 is the host name and 1434 is the assigned port.
Dieser Vorgang kann trotz einer geringen Datenmenge mehrere Stunden in Anspruch nehmen, da die Dateien auf dem Vault erst generiert werden müssen. <br>
 
<br />
 
  
== Backup Jobs hängen ==
+
After customization, you will see the correct instance in the Backup Portal if you select "Default".
Grundsätzlich sollte ein Beenden der Backupdienste für ca. 15 Minuten das Problem beheben. <br>
 
Alternativ kann ein Serverneustart durchgeführt werden. <br>
 
Falls ein Neustart nicht möglich ist können die Tasks durch das Beenden der Prozesse auf dem Server entfernt werden. <br>
 
Hierzu verwenden Sie die generierte (Prozess)ID aus dem Backupportal. <br>
 
Diese ID findet sich im Task-Manager unter „Details“ mit dem Prozessnamen VV.exe wieder. Das Beenden des Tasks schließt den Prozess im Backupportal. <br>
 
VVAgent.exe und buagent.exe sind hier die Dienstprozesse und können ignoriert werden. <br>
 
<br />
 
  
== Umlaufprotokollierung/Circular logging ==
+
=== Windows Agent Exchange Backup ===
Derzeit ist die Umlaufprotokollierung aktiviert. Diese sollte in Produktivumgebungen besser deaktiviert werden. "Umlaufprotokollierung wird für Produktionsumgebungen nicht empfohlen. <br>
+
-----
Quelle: https://technet.microsoft.com/de-de/library/bb331968%28v=exchg.80%29.aspx <br>
+
==== Circular logging ====
Im o.g. Link wird auch beschrieben, wie man die Umlaufprotokollierung auf einem Exchangeserver deaktiviert.  <br>
+
Circulation logging is currently enabled. It is better to disable it in production environments. "Circulation logging is not recommended for production environments. <br>
Ein informativer Artikel zum Thema Umlaufprotokollierung: <br>
+
Source: https://technet.microsoft.com/de-de/library/bb331968%28v=exchg.80%29.aspx <br>
 +
The above link also describes how to disable circulation logging on an exchange server. <br>
 +
An informative article on the subject of circulation logging: <br>
 
http://www.itadministrator.de/themen/kommunikation/123111.html <br>
 
http://www.itadministrator.de/themen/kommunikation/123111.html <br>
Alternativ können Sie auch die Sicherung der Transaktionsprotokolle deaktivieren. Dann wird nur die Exchangedatenbank gesichert, Transaktionsprotokolle werden außen vor gelassen. <br>
+
Alternatively, you can also disable the backup of transaction logs. Then only the Exchange database is backed up, transaction logs are left out. <br>
 
<br />
 
<br />
  
== Verknüpfte Hardlinks waren nicht ausgewählt und wurden nicht gesichert ==
+
==== Customization target mount path for Granular Exchange Restore ====
Diese Fehler zeigen an, dass es sich um Verknüpfungen handelt die auf Dateien verweisen, die nicht im Backupjob mit aufgeführt sind. Somit hat der Agent keine Rechte die Dateien zu sichern. <br>
+
By default, it is mounted below C:\RestoreMount. Unless there is enough space on the disk, another drive letter must be used. <br>
Bitte passen Sie den Backup-Job dementsprechend an. <br>
+
The registry key below can be used to customize the destination path. <br>
 +
<br>
 +
'''Solution:'''<br>
 +
Create the following registry entry with a string:<br>
 +
''HKEY_LOCAL_MACHINE\SOFTWARE\EVault\Infostage\Agent\MountAlternatePath=''<br>
 +
<br>
 +
No restart of the backup service is required.<br>
 +
<br>
 +
'''Example:'''<br>
 +
''HKEY_LOCAL_MACHINE\SOFTWARE\EVault\Infostage\Agent\MountAlternatePath=e:\mp''<br>
 +
<br>
 +
When e:\mp is used as a string, the release: ''\EX2007SERVER\e$\mp\GRT_000010_2013-06-25-10-13-43<br>
 +
[[Datei:MountAlternatePath.PNG|border|Alternativer Pfad]]<br>
 +
<br>
 +
'''Note:'''<br>
 +
Only possible with Granular Restore Tool 8.x or higher.<br>
 
<br />
 
<br />
  
== Der Treiber für die Protokollierung geänderter Blöcke kann die Änderungen für das Volume nicht protokollieren und/oder (Changed Block Tracking) ist nicht verfügbar ==
+
==== Validation failed for Exchange database Mailbox Database XYZ, reason: Timed Out ====
Es wurde nach der Installation des Imageplugins kein Neustart durchgeführt.
+
'''Error pattern:''' <br>
 +
You receive the following error message in the Exchange backup log files:
 +
''EX10-F-10379 Validation failed for Exchange database Mailbox Database XYZ, reason: Timed Out''
 +
 
 +
'''Cause:''' <br>
 +
Checking the database via the ESEUTIL takes too much time, this can be attributed to a heavy workload or too low performance of the system.
 +
 
 +
'''Recommended Action:''' <br>
 +
Please set the following registry entries to increase the timeout of the check and adjust the flow of the check (sequential):<br>
 +
HKEY_LOCAL_MACHINE\SOFTWARE\EVault\InfoStage\Agent\Ex2010SequentialValidation = 1 (DWORD)<br>
 +
HKEY_LOCAL_MACHINE\SOFTWARE\EVault\InfoStage\Agent\Ex2010ValidationTimeOut = 18000 (DWORD)<br>
 +
 
 +
Restart both TERRA CLOUD Backup services and try to start a backup again including a database check. <br>
 +
 
 +
=== Windows Agent Oracle Backup ===
 +
-----
 +
==== The credentials for the plug-in could not be verified due to an unexpected error. Verify that the credentials are correct and try again ====
 +
The Oracle plug-in uses the connection to the Oracle database EZCONNECT. Make sure that your configuration in the sqlnet.ora file is correct. <br>
 +
E.g.: <br>
 +
''# SQLNET.ORA Network Configuration File: d:\oracle\ora92\network\admin\sqlnet.ora'' <br>
 +
''# Generated by Oracle configuration tools.'' <br>
 +
''SQLNET.AUTHENTICATION_SERVICES= (NONE)'' <br>
 +
''NAMES.DIRECTORY_PATH = (EZCONNECT,TNSNAMES)'' <br>
 +
 
 +
Start Oracle listener and try again with a backup. <br>
 
<br />
 
<br />
  
== Falsche Sicherunggröße ==
+
== '''Hyper-V Agent''' ==
Dieser Fehler kann auftreten wenn die Shadowsize nicht limitiert ist. Wir empfehlen den Wert auf 10GB zu beschränken: <br>
+
 
vssadmin resize shadowstorage /for=<drive letter:> /on=<drive letter:> /maxsize=10GB <br>
+
===Hyper-V installation of Visual C++ 2017 Runtime(64) failed ===
'''Beispiel:''' <br>
+
'''Error pattern:''' <br>
''vssadmin resize shadowstorage /for=c: /on=c: /maxsize=10GB'' <br>
+
You receive the following error message in Setup during Hyper-V Management Agent installation:
''vssadmin resize shadowstorage /for=d: /on=d: /maxsize=10GB'' <br>
+
[[Datei:Hyper-V-Agent-Installation.jpg|gerahmt|ohne]]
Nach der nächsten Sicherung sollte der Wert korrekt angezeigt werden. <br>
+
'''Cause of error:''' <br>
 +
As already described in the error message, there was a problem with the runtime download. This error pattern occurs only sporadically.
 +
 
 +
'''Solution:'''<br>
 +
You can either cancel the setup and perform the installation again including the download of the runtime or download and install the runtime manually.
 +
 
 +
You can download the current runtime from the following link: <br>
 +
https://aka.ms/vs/16/release/vc_redist.x64.exe
 +
 
 +
For more information, please visit: <br>
 +
https://support.microsoft.com/de-de/help/2977003/the-latest-supported-visual-c-downloads
 +
 
 +
===Hyper-V VM is backed up by other process===
 +
'''Error code:''' <br>
 +
AGCD-E-10348 Virtual machine "XXX" ["VM-ID"] could not be backed up because it is currently being backed up by another process.<br>
 +
<br>
 +
'''Cause:'''<br>
 +
Here, no backup of the VM's can be performed because of leftover files due to an update of the Hyper-V Host Agent from version 7.x to version 8.60, <br>
 +
which are misinterpreted during the backup request. <br>
 +
<br>
 +
'''Solution:'''<br>
 +
Please change to the following directory and remove all files located there:<br>
 +
''C:\Windows\System32\config\systemprofile\AppData\Local\EVault Software\Agent Worker\Notifications Queue\''<br>
 +
 
 +
'''Note:'''
 +
<pre style="color: red"> First, please update to the latest version of the Hyper-V Agent, as this error pattern has been fixed in version 8.84.1309. </pre style="color: red">
 +
 
 
<br />
 
<br />
  
== System VSS Provider erzwingen ==
+
===Hyper-V unknown exception===
Mithilfe des folgendem Reg-Key können Sie den System VSS Provider erzwungen werden: <br>
+
'''Error message:'''<br>
HKEY_LOCAL_MACHINE\SOFTWARE\EVault\InfoStage\Agent\UseSystemVSSProvider = 1 (DWORD) <br>
+
"unknown exception" in back supportal during configuration/setup <br>
== Fehler beim Erfassen der Informationen zum Systembereitstellungspunkt ==
+
[[Datei:Unbekannte Ausnahme.png|border|unbekannte Ausnahme]]<br>
'''Problembeispiel:''' <br>
+
'''Cause:''' <br>
''27.abr. 22:00:49 BKUP-E-08235 Betriebssystemfehler 2, Meldung: Das System kann die angegebene Datei nicht finden'' <br>
+
Here, no backup of the VM's can be performed because of leftover files due to an update of the Hyper-V Host Agent from version 7.x to version 8.60,<br>
''27.abr. 22:00:49 BKUP-W-08732 Einhängepunkt-Informationen für System konnten nicht erfasst werden. [VV]04-May 23:45:29 BKUP-E-09401 An error occurred while collecting system mount point information. [VV]'' <br>
+
which are misinterpreted during the backup request. <br>
''04-May 23:45:28 BKUP-E-08235 O/S error 2, message: Das System kann die angegebene Datei nicht finden'' <br>
+
<br>
''04-May 23:45:29 BKUP-W-08732 Failed to collect system mount point information [VV]'' <br>
+
'''Solution:'''<br>
'''Ursache:''' <br>
+
Please change to the following directory and remove all files located there:<br>
orphaned mount point -> Neustart durchführen <br>
+
''C:\Windows\System32\config\systemprofile\AppData\Local\EVault Software\Agent Worker\Notifications Queue\''<br>
 +
 
 +
'''Note:'''
 +
<pre style="color: red"> First, please update to the latest version of the Hyper-V Agent, as this error pattern has been fixed in version 8.84.1309. </pre style="color: red">
 +
 
 
<br />
 
<br />
  
== FAILED_AT_FREEZE - VSS_E_WRITERERROR_TIMEOUT)> 0x800423f2 ==
+
===Hyper-V backup shows no progress===
in dem Logfile steht die folgende Meldung: <br>
+
'''Error code:'''<br>
FAILED_AT_FREEZE(0x800423f2 -VSS_E_WRITERERROR_TIMEOUT)> <br>
+
A previously working backup starts after the update to 8.60, but no progress is apparent.<br>
Diese Meldung taucht auf wenn die Performance zu schwach ist. Bitte prüfen Sie das System. Ggf, können Sie den VSS-Timeout erhöhen: <br>
+
[[Datei:Job hängt.PNG|border|Sicherung scheint zu hängen]]<br>
https://blogs.technet.microsoft.com/asiasupp/2011/08/01/windows-server-backup-failed-to-backup-with-error-0x81000101/  <br>
+
'''Cause:'''<br>
Sollte der Server in der Cloud liegen, kontaktieren Sie uns Bitte per Mail support@terracloud.de oder telefonisch unter (-850) und nennen Sie uns bitte einmal die Paketnummer." <br>
+
Here, no backup of the VMs can be performed because of leftover files due to an update of the Hyper-V Host Agent from version 7.x to version 8.60, <br>
 +
which are misinterpreted during the backup request. <br>
 +
<br>
 +
'''Solution:'''<br>
 +
# Stop the agent services of the MGMT agent and all host agents<br>
 +
# Please change to the following directory (step 3) and remove all files located there:<br>
 +
# ''C:\Windows\System32\config\systemprofile\AppData\Local\EVault Software\Agent Worker\Notifications Queue\''<br>
 +
# Please restart the agent services of the MGMT and all host agents. <br>
 +
 
 +
'''Note:'''
 +
<pre style="color: red"> First, please update to the latest version of the Hyper-V Agent, as this error pattern has been fixed in version 8.84.1309. </pre style="color: red">
 +
 
 
<br />
 
<br />
  
== Lücke in den Protokolldateien ==  
+
===Hyper-V FAILED_GeneralFailure===
Erscheint in Verbindung mit VSS Problemen die nicht weiter beachtet werden müssen. <br>
+
'''Error message:'''<br>
"Eine Lücke in den Protokolldateien für Datenbank OeffentlicheOrdner wurde festgestellt. Sie müssen erneut eine vollständige Sicherung durchführen." <br>
+
The backup job of a Hyper-V agent aborts right after startup and deposits the following error message in the log file: <br>
'''Lösung:''' <br>
+
''AGCD-E-08383 VSS snapshot operation completed with result 'FAILED_GeneralFailure'' <br>
Sie müssten den Job einmal manuell starten ("Aktion auswählen" => "Job ausführen"). Hierbei bitte die Standardeinstellung belassen (wichtig: ""Sicherungstyp"" muss auf ""Vollständig"" stehen) und den Job starten. <br>
+
 
Im Anschluss sollte auch die tägliche Sicherung wieder erfolgreich ausgeführt werden. <br>
+
'''Cause:''' <br>
Bei Backupvorgängen werden durch den TERRA Cloud Backupagenten die Transaktionslogs gesichert und anschließend gelöscht. In Ihrem Fall hat offenbar eine andere Backuplösung diese Transaktionslogs abgeschnitten. <br>
+
In this case, there is a VSS integration failure between the host and VM.
Bitte deaktivieren Sie die Backupsoftware von Drittanbietern. <br>
+
 
Alternativ kann unser Agent Transaktionslogs ignorieren und nicht mit sichern. Konfigurieren Sie dazu im Zeitplan den Sicherungstyp auf "Inkrementell". <br>
+
'''Recommended Action:''' <br>
 +
1. please remove the following option in the integration services of the VMs to be backed up and confirm with "OK":
 +
 
 +
[[Datei:Hyper-V VSS.png|gerahmt|ohne]]
 +
 
 +
2. lead start a backup afterwards, this backup should fail due to the lack of VSS support via the integration services. <br>
 +
 
 +
3. please re-enable this option for all system and try to backup again. <br>
 +
 
 +
'''Note:'''
 +
<pre style="color: red"> First, please update to the latest version of the Hyper-V Agent, as this error pattern has been fixed in version 8.84.1309. </pre style="color: red">
 +
 
 +
=== Hyper-V backups are no longer started via the schedule ===
 +
'''Error pattern:''' <br>
 +
The Hyper-V Agent no longer starts a backup via the schedule.<br>
 +
 
 +
'''Solution:''' <br>
 +
Please store the encryption password again in the backup job in which you edit the job. <br>
 +
 
 +
=== Hyper-V update from 8.60 to 8.X fails ===
 +
'''Error message:''' <br>
 +
You receive the following error message during the update installation of the management and host components of agent version 8.X:
 +
 
 +
''Error 1316.The specified account already exists.''
 +
 
 +
[[Datei:Error1316.png|gerahmt|ohne]]
 +
 
 +
'''Cause:'''<br>
 +
One registry entry each for the MGMT and the host components is incorrect and prevents the update from 8.60 to 8.X.
 +
 
 +
'''Solution:'''<br>
 +
# Please open the registry on the systems on which the individual components are installed
 +
# Search for the following GUID of the MGMT agent 27FB23FA45CDCCA419AFA539FAB44906 and click on the folder "SourceList".
 +
Change the value of the PackageName key to TERRA Cloud Backup Hyper-V Agent Management.msi and save it.
 +
# Search the registry of the systems on which the Host Agent is installed for the GUID 2BFC6FB3019E15D449DEFDFA7BA62BA0
 +
# Navigate to the "SourceList" folder and change the value of the "PackageName" key to TERRA Cloud Backup Hyper-V Agent Host.msi and save it
 +
# After that you can perform the update
 +
 
 +
== '''Linux Agent''' ==
 +
 
 +
=== DISK-F-04144 Error opening file /var/lib/lxcfs ===
 +
'''Error pattern:''' <br>
 +
You receive an error message in the log file of a Linux BMR job that files below the /var/lib/lxcfs/ directory cannot be backed up due to lack of permission.
 +
 
 +
'''Cause:''' <br>
 +
It is a FUSE file system for the use of Linux containers, within this system the root user does not have the necessary permissions.
 +
 
 +
'''Further information on the subject:'' <br>
 +
https://ubuntu.com/blog/introducing-lxcfs <br>
 +
https://linuxcontainers.org/lxcfs/introduction/ <br>
 +
 
 +
'''Recommended Action:''' <br>
 +
Since this directory is not necessary for a BMR restore, you can remove this directory on the backup job.
 +
After exclusion, the error message no longer appears.
 +
 
 +
[[Datei:Exklusion lxcfs.jpg|gerahmt|ohne]]
 +
 
 +
=== Delta file not found / damaged ===
 +
'''Error pattern:'''<br>
 +
You will receive the following error message in the log file:
 +
 
 +
''BSTR-E-04166 File not found /opt/BUAgent/localjob/0000XY.DTA''
 +
''BKUP-E-08194 Delta file is missing. Synchronize the job to recreate the delta file. [VV]''
 +
 
 +
In case of a corrupted delta file, the error pattern looks very similar.
 +
 
 +
'''Cause:''' <br>
 +
The agent cannot access the delta file because it either does not exist as in the example above or is corrupted and the stored checksum of the file does not match the one currently measured.<br>
 +
 
 +
'''Solution:''' <br>
 +
On the protected system, check in the agent directory if there are .DTA and .DTX files in the job folder, if not you can start a synchronization of the job in the Backup Portal. <br>
 +
If there are files, please remove them via ''rm DATEINAME'' or e.g. via WinSCP. Please start a synchronization of the job afterwards.
 +
 
 +
 
 +
=== An additional process starts during a backup/restore/synchronization ===
 +
'''Error pattern:''' <br>
 +
When a Linux backup job is executed, a second "empty" process starts.
 +
 
 +
On this screenshot you can see an "empty" process that is still active after two other processes have finished.
 +
 
 +
'''Note:''' <br>
 +
This error pattern has already been passed on to the software manufacturer; it is merely a display error, since there is no process with the displayed process ID on the corresponding system.
 +
 
 +
[[Datei:Leerer Prozess Linux.png|gerahmt|ohne]]
 +
 
 +
=== Linux system is displayed as "Offline" in the portal ===
 +
'''Error pattern:''' <br>
 +
In the Backup Portal, a Linux Agent is displayed as "Offline" even though the backed up system is active and backups are still being performed.
 +
 
 +
'''Cause:''' <br>
 +
The "VVAgent" service is no longer working correctly or has stopped.
 +
 
 +
'''Solution:''' <br>
 +
On the system in question, run the following command, for example, to restart the service:
 +
 
 +
''/etc/init.d/vvagent restart''
 +
 
 +
'''Alternative:''' <br>
 +
 
 +
''systemctl restart VVAgent''
 +
 
 +
=== BMR -E-07393 Unknown message: ID = 10596 Parameter0 = /Bare_Metal_Restore_Image.iso ===
 +
'''Error pattern:''' <br>
 +
You receive the following error message in the log file of a BMR Linux job: <br>
 +
''BMR -E-07393 Unknown message: ID = 10596 Parameter0 = /Bare_Metal_Restore_Image.iso''
 +
 
 +
If you have configured the language in the Backup Portal to English, you will receive the following error message: <br>
 +
''BMR -E-10596 The backup agent cannot find the ISO image at the user configured location {1}.''
 +
 
 +
'''Cause:''' <br>
 +
The system to be backed up does not have Relax and Recover version 2.5 installed. <br>
 +
Please note that currently '''only''' the version '''2.5''' is supported.(As of January 2021)
 +
 
 +
'''Recommended Action:''' <br>
 +
Please check the installed version first via the following command: <br>
 +
<code>rear-V</code>
 +
 
 +
If the version is lower than 2.5, you can update it to 2.5.
 +
In the case of a newer version, you would need to downgrade in the form of uninstalling and reinstalling version 2.5.
 +
 
 +
For more information and guidance on rear, please visit: <br>
 +
https://relax-and-recover.org/documentation/
 +
 
 +
== '''VMware vSphere Recovery Agent''' ==
 +
 
 +
=== VSPH-W-10566 Failed to verify SQL Server transaction logs were truncated for instance ESXI-SQL on VM {1}. ===
 +
'''Error pattern:''' <br>
 +
You receive the following warning message in the log file during a backup job of a vSphere Recovery Agent version 8.82 or later:
 +
 
 +
''VSPH-W-10566 Failed to verify that SQL Server transaction logs were truncated for instance ESXI-SQL on VM {1}.''
 +
 
 +
'''Cause:''' <br>
 +
The vSphere Recovery Agent cannot check if the transaction logs are truncated on a German SQL installation.
 +
Presumably, this error pattern occurs with all non-English installations.
 +
 
 +
'''Recommended Action:''' <br>
 +
Please change the setting for truncation of transaction logs to "Backup with copy only" (see screenshot).
 +
 
 +
[[Datei:Sicherung nur mit Kopie.png|gerahmt|ohne]]
 +
 
 +
The transaction logs can be optinally truncated via board means of Microsoft SQL.
 +
Alternatively, you can install a Windows agent including SQL plug-in in the VM and protect the database via an SQL backup job. In this scenario, you back up the system via a host backup and the database additionally via an application-consistent agent backup.
 +
 
 +
=== VSPH-W-10274 Virtual machine "Name of VM" could not be suppressed. The backup will try a crash consistent snapshot instead ===
 +
'''Error pattern:''' <br>
 +
You will find the following error message in the log file:
 +
''VSPH-W-10274 Virtual machine "Name of VM" could not be suppressed. Backup will attempt a crash consistent snapshot instead.''
 +
 
 +
'''Cause:''' <br>
 +
The vSphere Recovery Agent cannot stop the file system inside the VM through vCenter because the Quiesce guest file system feature is not available.
 +
 
 +
'''Recommended Action:''' <br>
 +
Please check if the option shown below is available in vCenter when creating a snapshot.
 +
Verify that VMware Tools are installed and up to date within the VM.
 +
If you are still unable to use this feature, please contact VMware Support as it is an issue with the hypervisor.
 +
[[Datei:Snapshot erstellen.png|gerahmt|ohne]]
 +
 
 +
=== VSPH-I-10525 An old version of VMware tools is installed on VM XYZ. Update the VMware tools to the current version ===
 +
'''Error pattern:''' <br>
 +
You will receive information in the log file that the installed VMware tools on a VM are outdated and thus no application-consistent backup can be created.
 +
 
 +
'''Cause:''' <br>
 +
For an application-consistent backup, the Microsoft VSS components must be addressed within the VM. To use this feature, at least version 11 or higher must be installed.
 +
 
 +
'''Recommended Action:''' <br>
 +
Please check the version number of VMware Tools e.g. in vCenter and update it.
 +
 
 +
An example, after the update an application consistent backup is possible.
 +
[[Datei:VMware Tools.png|gerahmt|ohne]]
 +
 
 +
For more information, see the latest [https://drive.terracloud.de/dl/fiLpZboTGRPeqzW1cqwS6yin/Documentation_and_Release_Notes documentation] of the vSphere Recovery Agent.
 +
 
 +
== '''TERRA CLOUD Backup Satellite''' ==
 +
 
 +
=== Backup "Job cannot be registered to the Vault. It may already exist in the Vault." (Only in connection with a satellite) ===
 +
 
 +
'''Cause:''' <br>
 +
As long as the satellite is set to "Bypass inactive", a computer or a backup job cannot be registered directly to the Basevault, because the Basevault is set as the current backup destination in the Vault settings.<br>
 +
 
 +
'''Solution:''' <br>
 +
Please store the local IP address of the satellite in the Vault settings and try to create the job or add the computer again.
 
<br />
 
<br />
  
== Oracle ==
+
=== Time in satellite is not correct ===
Bitte beachten Sie zunächst die umfangreiche Dokumentation, die Sie unter der folgenden Adresse herunterladen können https://backup.terracloud.de/Download/Documentation.zip. <br>
+
'''Causes:''' <br>
Im ZIP-Archiv unter Documentation\EN\Oracle_Plug_In_8.0a.pdf finden Sie nähere Informationen zum Oracle Plugin.  <br>
+
The bandwidth limitation adheres to the receiving time. If the time is out of sync, the plan will not work correctly. <br>
Sofern es weiterhin Probleme gibt, benötigen wir eine Dokumentation über die von Ihnen durchgeführten Schritte - inkl. einer Fehlermeldung.  <br>
+
'''Solution:''' <br>
Im Idealfall das Ganze auf Englisch - so können wir (sofern es sich um einen unbekannten Fehler handelt) direkt einen Case beim Softwarehersteller eröffnen. <br>
+
Please share port NTP port 123/UDP from satellite to internet. <br>
 
<br />
 
<br />
  
== Von der Datenbank wurde noch keine erfolgreiche vollständige Sicherung erstellt ==
+
== '''BMR recovery''' ==
Der Fehler tritt auf, wenn der MS SQL-VSSWriter Dienst unter dem Systemkonto ausgeführt wird. <br>
+
=== Checklist troubleshooting BMR recovery ===
Wenn die Anmeldeinformationen des Dienstes auf einen AD-Account mit Adminrechten umgestellt werden, sollte die Sicherung fehlerfrei laufen. <br>
+
'''General:''' <br>
 +
In the event of an error, please go through the following checklist during or after a BMR recovery.<br>
 +
Based on the answers, the error pattern, if not already covered by the Troubleshooting Guide, can be narrowed down.<br>
 +
Furthermore, the checklist enables a faster and more efficient support process.
 +
 
 +
'''Checklist:'''
 +
#Is this a production restore or a test restore?
 +
#When was the last time the system was restored in a test recovery?
 +
#Which version of the Restore ISO was used? &rarr; ''Please always use the latest version.''
 +
#Have you restored a file or image based backup job?
 +
#Does the problem occur while configuring the backsight? ''If Yes'' &rarr; ''Please check the procedure in the [https://drive.terracloud.de/dl/fiLpZboTGRPeqzW1cqwS6yin/Documentation_and_Release_Notes.zip documentation] for this.
 +
#Have you already saved log files of BMR backups? ''If no'' &rarr; ''A for this you find instruction under'' [[#Logfiles_of_a_BMR-R.C3.BCckbackup_save|Save logfiles of a BMR backups]]
 +
#Successful recovery to a physical or virtual system? ''If virtual'' &rarr; ''what virtualization technology is used?''
 +
Is the source system a BIOS or UEFI installation? &rarr; ''The firmware used decides the VM generation, e.g. for Hyper-V.''
 +
#Have you restored all volumes or only those necessary for the operating system?
 +
#Were different backup points/safesets already selected for the restore?
 +
#What is the role/purpose of the source system? &rarr; ''e.g. DC, MS-SQL, file server etc.''
 +
 
 +
'''Tips:'''<br>
 +
A faulty production restore causes a stressful situation and downtime should be kept as short as possible.
 +
The following tips can simplify the fault clearance process and save valuable time.
 +
 
 +
'''Parallel recovery:'''<br>
 +
You can restore simultaneously from the primary and secondary Vault and, if necessary, a satellite.
 +
This provides you with backups from at least two sources at the same time.<br>
 +
The FQDNs and Public IPs can be found in the [https://backup.terracloud.de/Download/ip_overview.pdf Vault overview].
 +
 
 +
'''Pursue multiple solution paths simultaneously:'''<br>
 +
Example: <br>
 +
After restoring the latest safeset, the system booted into a blue screen because there was operating system corruption at the time of the backup. <br>
 +
In this scenario, you could restore two older safesets from, say, three days ago and the end of last month at the same time, using '''Parallel Restore'''. <br>
 +
This strategy doubles the chances of hitting a backup point that contains the system's data before the operating system is corrupted.
 +
 
 +
'''Recovery in a disaster recovery VM:'''<br>
 +
The TERRA CLOUD offers you the possibility to provide a virtual machine or a virtual disaster recovery environment in a fully automated way.<br>
 +
Take advantage of this offer to initiate a secondary recovery into a completely new environment based on Microsoft Hyper-V, in addition to the primary recovery debugging.<br>
 +
If recovery to the original system/environment is not possible, restoring to a DRVM may increase the chance.
 +
 
 +
'''Documentation of the recovery:'' <br>
 +
Please attach screenshots of error messages/incorrect behavior directly to a support ticket or request.
 +
By providing documentation in the form of the checklist and screenshots, you shorten the information gathering part of a support ticket.
 +
-----
 +
 
 +
=== System boots into a boot error/bluescreen/blackscreen after a restore ===
 +
'''Error pattern:''' <br>
 +
After a successful BMR restore, the system displays a boot error after startup, such as the following:
 +
[[Datei:BSOD.jpg|border|600px|ohne]]
 +
 
 +
'''Procedure:''' <br>
 +
Please go through the [[Backup_Troubleshooting#Checklist_Troubleshooting_BMR-Restore|Checklist Troubleshooting BMR Restore]] first and provide the results to support if necessary.
 +
 
 +
'''Recommended actions:''' <br>
 +
Please check if you can work around the error with the following instructions.
 +
 
 +
'''BMR operating system volume restore:'''
 +
# Run the BMR restore again and restore only the volume for the operating system
 +
# Check if the system can boot after successful recovery
 +
# Provided the system can boot, install a Windows agent in the system and register it in the portal
 +
# Restore the remaining volumes via the Backup Portal, e.g. via restore from another computer
 +
 
 +
=== Save log files of a BMR backup ===
 +
'''General:'''<br>
 +
To debug a BMR recovery, it may be necessary to access detailed recovery log files.
 +
The recovery software offers three different levels of detail for the log files in the settings:
 +
*DEBUG
 +
*LOG WARNING
 +
*LOG ERROR
 +
 
 +
The "DEBUG" option offers the highest level of detail and is thus best suited for troubleshooting.
 +
However, there is often a problem that the log files are discarded by the reboot after the failed recovery or cannot be saved outside the system beforehand.
 +
 
 +
'''Best practice for providing log files of a BMR back-up:'''<br>
 +
The following instructions show you a recommended way to save log files for debugging a BMR back-up and make them available to TERRA CLOUD Support.
 +
 
 +
The log files must be stored outside the storage area relevant for the restore. This can be done on a network share or a local volume.
 +
 
 +
[[Datei:Debug-log.jpg|gerahmt|ohne]]
 +
 
 +
'''Network sharing procedure:'''<br>
 +
Please restart the recovery for debugging and select the log level "DEBUG" in the settings under "Log Settings".
 +
You can store your network share as the storage destination. After the restore, please send the saved log file to TERRA CLOUD Support.
 +
 
 +
'''Procedure "Local Disk":'''<br>
 +
Please provide the target system with another volume of at least 20 GB, as the log files can become very large depending on the size of the recovery.
 +
If this is not possible, e.g. because it is a physical server, we recommend booking a disaster recovery VM in the TERRA CLOUD including an additional VHDX for the log files.
 +
 
 +
You can set up the additional hard disk from the command prompt in the main menu of the recovery software using Diskpart.
 +
In the following screenshot, Notepad has been opened from the command line to show the volume set up via Diskpart:
 +
[[Datei:Debug-vhdx.jpg|gerahmt|ohne]]
 +
After that, please navigate to the settings under "Log Settings" and select the log level "DEBUG".
 +
You can then select the extra volume set up as the storage destination.
 +
After the recovery is complete, please provide the saved log file from the volume to TERRA CLOUD support.
 +
 
 +
=== Failed to GetDiskDetails ===
 +
'''Error pattern:'''<br>
 +
During a BMR recovery you will receive the following error: <br>
 +
[[Datei:FailedtoGetDiskDetails.png|border|Failed to GetDiskDetails]]<br>
 +
<br>
 +
'''Cause:'''<br>
 +
The Restore ISO is not able to process the job details from our Vault.<br>
 +
<br>
 +
'''Solution:'''<br>
 +
 
 +
'''Note:'''<br>
 +
In this case, if it is a disaster recovery VM within the TERRA Cloud, the required RestoreAPI_IS.dll is already stored for you in the ISO. <br>
 +
You can proceed directly to step 2 and start the recovery. <br>
 +
 
 +
Step 1: <br>
 +
Please paste the following [https://drive.terracloud.de/getlink/fiY9vX7LtyNr9GyR93gAimhx/Troubleshooting file] into the restore iso, you can use the following [http://de.winiso.com/ software] for this. <br>
 +
<br>
 +
Step 2: <br>
 +
Start the recovery with the edited ISO.<br>
 +
<br>
 +
Step 3: Select the language German, then open the menu item Command Prompt and proceed as follows:<br>
 +
*Type "taskmgr" to open the task manager. Then close the "Carbonite Server Backup System Restore Main..." process.
 +
*Next, enter the following commands in the ''X:\Windows\System32\RestoreApp>'' path:<br>
 +
#''del RestoreAPI_IS.dll''<br>
 +
#''copy D:\RestoreAPI_IS.dll .'' (Note partition name of ISO file, test if necessary. By default D:\)<br>
 +
#''RestoreApp.exe''
 +
<br>
 +
Step 4: Afterwards, perform the recovery.<br>
 
<br />
 
<br />
  
== System Writer fehlt - BMR nicht verfügbar ==
+
=== Device Manager failed to get current information ===
Der folgende Link stellt einen Workaround für dieses Fehlerbild dar: <br>
+
This error message appears after the password for the Restore Point backup job is entered. <br>
https://blogs.msdn.microsoft.com/ntdebugging/2013/08/27/missing-system-writer-case-explained/ <br>
+
[[Datei:System Restore Wizard PW.jpg|System Restore Wizard]] <br>
 +
[[Datei:System Restore failed.jpg|Device Manager failed to get current information]] <br>
 +
 
 +
'''Solution:'''<br>
 +
The SCSI controller driver from "Paravirtual" must be changed to "LSI Logic SAS". <br>
 
<br />
 
<br />
  
== \\?\GLOBALROOT\Device\HarddiskVolume2\EFI\Microsoft\Boot\BCD.LOG ==
+
=== Restore BIOS system on an EFI system ===
Grundsätzlich handelt es sich hierbei um einen VSS Fehler, da die Dateien nicht in Anspruch genommen werden können. <br>
+
'''Error pattern:''' <br>
Hierzu finden Sie in der Schnellstartanleitung auf Seite 36 einen VSS-Guide. https://downloads.terracloud.de/files/DE_Dokumentation/terra%20CLOUD_Backup_Schnellstart.pdf <br>
+
You will receive the following error message in "Step 3 Map Volumes" during recovery:
Wenn Sie das Backup eine Stunde früher oder später laufen lassen, könnte dies schon zu einer Besserung führen. Vereinzelt wurde uns die lokale Antivirensoftware als Problemursache genannt. <br>
+
 
<br />
+
''You cannot drag the volume to this position because the new order of partitions would violate Microsoft Rules. <br>
 +
The partitions schould be in the following order: Recovery (if any), ESP(if any), MSRP and then primary data partition(s). <br>
 +
Please delete all partitions on this disk and try again.'' <br>
 +
 
 +
[[Datei:BMR Restore-Fehlerbild GEN1 in GEN2.png|gerahmt|ohne]]
 +
 
 +
'''Cause:''' <br>
 +
You see in the screenshot the error image that a Hyper-V GEN1 VM (BIOS) should be restored in a Hyper-V GEN2 VM (UEFI). This is not possible due to the different firmware of the two VM generations.
 +
 
 +
'''Solution:''' <br>
 +
 
 +
'''Hyper-V:''' <br>
 +
Create a new VM in the same generation as the source system (in the example above, a GEN1 VM should be created for recovery).
 +
 
 +
'''VMware:''' <br>
 +
You can create a new VM via the vCenter or the Host Client and decide via the "Firmware" option whether EFI (Required for GEN2 VMs) or BIOS (Required for GEN1 VMs) is to be used.
 +
is to be used for the VM.
 +
 
 +
In the following screenshot you can see the creation process of a VM in vCenter:
 +
[[Datei:VMware Generation.png|gerahmt|ohne]]
 +
 
 +
'''TERRA CLOUD IaaS VM:'' <br>
 +
You can decide if a GEN1 or GEN2 should be deployed when ordering an IaaS VM just before the configuration is complete, this generation must again match the firmware or generation of the source system.
 +
 
 +
'''Alternative solution:''' <br>
 +
Restoring a BIOS system to a UEFI system is possible, but '''not recommended'''. <br>
 +
To do this, convert the target volumes for the system partition to GPT (by right-clicking on the disk icon) and drag only the system partition from the source to it. <br>
 +
The Microsoft System Reserved partition does not need to be dragged from the backup to the target, only other data partitions if present. <br>
 +
 
 +
=== Restore EFI system to a BIOS system ===
 +
'''Error pattern:''' <br>
 +
You will get the following error message in "Step 3 Map Volumes" during recovery: <br>
 +
 
 +
''an EFI System partition can only be restored to a System using UEFI not a BIOS system''
 +
 
 +
[[Datei:Restore von GEN 2 in GEN 1.png|gerahmt|ohne]]
 +
 
 +
'''Cause:''' <br>
 +
You see in the screenshot the error image that a Hyper-V GEN2 VM (UEFI) should be restored in a Hyper-V GEN1 VM (BIOS). This is not possible due to the different firmware of the two VM generations.
 +
 
 +
'''Solution:''' <br>
 +
 
 +
'''Hyper-V:''' <br>
 +
Create a new VM in the same generation as the source system (in the example above, a GEN2 VM should be created for recovery).
 +
 
 +
'''VMware:''' <br>
 +
You can create a new VM via the vCenter or the Host Client and decide via the "Firmware" option whether EFI (Required for GEN2 VMs) or BIOS (Required for GEN1 VMs) is to be used.
 +
is to be used for the VM.
  
== Zuviele Sicherungen hintereinander ==
+
In the following screenshot you can see the creation process of a VM in vCenter:
Leider ist die Häufigkeit der Sicherung in der Zeit von 8-17 Uhr das Problem. Während dieser Zeit läuft die Maintenance zum Bereinigen der Jobs.  <br>
+
[[Datei:VMware Generation.png|gerahmt|ohne]]
Eine Sicherung während des Zeitraums unterbricht die Maintenance und ggf. werden die Safesets nicht bereinigt. <br>
 
Eine Verbesserung dieses Prozesses ist für das kommende Jahr geplant, so dass Sicherungen zu jeder Zeit ohne Probleme durchgeführt werden können. <br>
 
  
Bis dahin gäbe es praktisch nur die folgenden Möglichkeiten: <br>
+
'''TERRA CLOUD IaaS VM:'' <br>
1) In der Zeit von 08:00 bis 17:00 Uhr keine Datensicherungen durchführen, da hier die Vault-Maintenance durchgeführt wird. <br>
+
When ordering an IaaS VM, you can decide shortly before the configuration is completed whether a GEN1 or GEN2 should be provided, this generation must again correspond to the firmware or generation of the original system
- oder - <br>
 
2) Sie statten den Kunden mit einem Satelliten aus, dieser ist deutlich unanfälliger gegen diese Problematik. Die Replikation sollte auch hier in den Abendstunden erfolgen.  <br>
 
- oder - <br>
 
3) Sie nutzen tagsüber eine andere Backupsoftware (z.B. Windows Serverbackup) und führen die Datensicherung z.B. auf ein NAS durch. Abends kann dann natürlich die Offsite-Sicherung über TERRA Cloud Backup erfolgen. <br>
 
Sofern es sich um hochkritische Systeme handelt, wäre eine „Continuous Data Protection“ (z.B. von DataCore) am besten geeignet. <br>
 
<br />
 
  
== Unable to back up local storage virtual machine ==
+
== '''Bootable Media Creator''' ==
Deutet das darauf hin, dass nur die Hyper-V Managementkomponente installiert wurde und nicht die Hostbackup Software.  <br>
 
Bitte prüfen Sie ob beide Komponenten installiert wurden. <br>
 
<br />
 
  
== User can only retrieve your own profiles ==
+
=== Creating a bootable USB stick fails with error code 1 ===
Bei dieser Fehlermeldung reicht es in der Regel aus sich einmal neu einzuloggen. <br>
+
'''Error pattern:'''<br>
Es kommt hin und wieder vor, dass die Vererbung der Resellerebene auf "Site"-Ebene etwas dauert. <br>
+
You get the following error when you try to prepare a bootable stick with Bootable Media Creator:<br>
<br />
+
[[Datei:BMC - Error1.png]]
  
== Beseitigung der Delta-Dateien nach einem BMR-Restore ==
+
'''Cause:'''<br>
bitte führen Sie den „Backup_Fix“ im Agentenverzeichnis auf dem betroffenen System aus. Administrationsrechte(PowerShell ISE) sind erforderlich. <br>
+
This error pattern only occurs on systems that are not installed in English. <br>
https://drive.terracloud.de/dl/fi9HkpiHdS2uBdZMsmhuZqyj/backup_fix.zip <br>
+
We have already forwarded this to our software vendor to extend support for additional languages.
  
Nach der Durchführung muss das Verschlüsslungskennwort erneut eingetragen werden und Sie müssen eine Synchronisierung starten. <br>
+
'''Solution:'''<br>
<br />
+
Please create the ISO locally first. You can create a bootable stick via the software [https://rufus.ie/de_DE.html Rufus].
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
'''''Bei weiteren Anliegen zögern Sie nicht uns per Mail (support@terracloud.de) oder telefonisch unter (-850) zu kontaktieren.''''' <br>
+
'''''If you have any further concerns, please do not hesitate to contact us by email (support@terracloud.de) or by phone at (-850).''''' <br>
'''''Ihr terraCLOUD Team''''' <br>
+
'''''Your TERRA Cloud Team''''' <br>

Aktuelle Version vom 13. Juli 2022, 14:03 Uhr

Inhaltsverzeichnis

VSS Troubleshooting Guide

Error pattern:
The backup is aborted or is completed with errors. VSS errors/errors are displayed in the logs (e.g.: VSS -E-05408, VSS -E-05591).
VSS errors can take many different forms.

Possible causes:
The VSS providers are used by another process (other backup software, other backup jobs). The VSS providers are not fully present or are defective. The agent requires functional VSS providers. We rely 100% on Microsoft VSS for this - our Agent does not bring its own VSS providers. If there are problems on the part of Microsoft VSS, it can lead to errors occur.

Recommended Action:
1. check the schedule. It is not possible to start multiple backup jobs at the same time on the system, as the VSS components will then compete.
Restart the server once. Often a reboot helps to solve VSS problems.
3. install all available Windows updates.
Additional memory is required for VSS snapshots. Check if you have enough free memory on the system (at least 25GB).
Disable third-party backup software (Acronis, Backup Exec, etc.).
6. the size limit of the shadow storage should be adjusted. Run the following command per partition:
vssadmin resize shadowstorage /for=<drive letter:> /on=<drive letter:> /maxsize=10GB

Example:
vssadmin resize shadowstorage /for=c: /on=c: /maxsize=10GB
vssadmin resize shadowstorage /for=d: /on=d: /maxsize=10GB
7. delete old VSS snapshots with the command:

vssadmin delete shadows /all

8. run the following command and send us the output: vssadmin list writers and vssadmin list providers
After setting, you would need to restart both TERRA CLOUD BACKUP services once.
Check the Windows Event Log. Look for "vss" and "volsnap" errors that occur around the time of the backup.

Often it helps to search the Internet for the event ID of the error to get a hint for the actual cause of the error.

9a. Provided you have configured a file-based BMR job:
Install the image plug-in and create an image-based BMR job. Test whether the behavior also occurs with it. 9b. If you have configured an image-based BMR job: Uninstall the image plug-in and create a file-based BMR job.
Please include only "Bare Metal Restore" in the job. Test whether the behavior also occurs with it. 10. create VSS snapshot manually:

On Windows Server operating systems a VSS snapshot can be created via PowerShell, we recommend to test this once in case of VSS problems.
You can create a snapshot manually with the following command:
vssadmin create shadow /for=C:
As an example, we have created a snapshot for C:, if this is not possible, there are fundamental VSS problems on the system that are not caused by the TERRA CLOUD Backup Agent.


VSS graphical user interface

In addition to accessing the Microsoft Shadow Copy Service through PowerShell, you can also access it through a graphical interface.
Via this interface you can e.g: Configure the shadow storage on which the shadow copies are stored (e.g. define the size).

  1. Manually create shadow copies, e.g. to check the functionality

From the properties of a volume, you can access the graphical interface via the "Shadow Copies" tab:

VSS GUI.jpg

Force system VSS provider

Using the following registry key, TERRA CLOUD Backup Agent always uses Microsoft Shadow Copy Provider 1.0:

HKEY_LOCAL_MACHINE\SOFTWARE\EVault\InfoStage\Agent\UseSystemVSSProvider = 1 (DWORD)

Please restart both TERRA CLOUD Backup services after this configuration:

  • TERRA Cloud Backup BUAgent
  • TERRA Cloud Backup Agent

Hyper-V VSS Writer exclusion

Error pattern:
Backup jobs with the "BMR" option fail due to Microsoft VSS error messages on a Hyper-V host.
Problem:
Only the system partition on a physical Windows server ("host") with the Hyper-V role enabled is backed up.
The virtual machines (located on other partition) are explicitly backed up using the agent.
The Backup Agent on the HOST during the backup of drive C: also puts the VMs into the "backup in progress" state, i.e. activates a VSS functionality.

Cause:
The backup agent only triggers the Microsoft VSS provider to put the system itself (not "just" what was included) into a consistent state.
At the time of snapshot creation, the operating system does not "know" that actually only C is affected.
Only the agent reads, compresses, encrypts, and transfers from the VSS snapshot only the data included in the job.
According to current knowledge, the Hyper-V VSS Writer is responsible for the described behavior.

Solution:
A BMR backup of the Hyper-V host is not recommended, for a separate post on this see: Hyper-V Server Host BMR Backup. If you still want to backup the C partition, please exclude the Hyper-V VSS Writer from the backup:

Hyper-V VSS Writer Exclusion Guide:

1.) Stop the TERRA CLOUD Backup Agent services using Powershell:

Get-Service -DisplayName "TERRA Cloud Backup*" | Stop-Service

2.) In the installation directory you will find the job configuration files (<jobname>.vvc)

Example:

  • "BMR.vvc".


Create a copy of the job file, e.g. with the name "BMR.vvc.backup"

Edit the job file "BMR.vvc" and add the following part to the end:
VSSWriterBackup001 {
Name = Microsoft Hyper-V VSS Writer
InstName =
ID = 66841cd4-6ded-4f4b-8f17-fd23f8ddc3de
Include = ".\*"
Options = 4
}
Provided that it is a cluster, there is certainly still a writer in the system for the cluster shared volumes (you can find out via vssadmin list writers).
Provided that this is the case, this Writer should also be excluded:

VSSWriterBackup002 {
Name = Cluster Shared Volume VSS Writer
InstName =
ID = 1072ae1c-e5a7-4ea1-9e4a-6f7964656570
Include = ".\*"
Options = 4
}

3.) Start the TERRA CLOUD Backup Agent services using Powershell:
Get-Service -DisplayName "TERRA Cloud Backup*" | Start-Service

4.) Perform a backup

5.) If the backup was not successful or the problem still occurs, please restore the previously saved job configuration file.

VSS -E-05600 - System Writer missing - BMR not available

Error pattern:

You will receive the following error message in the log file:

VSS -E-05600 Components of System Writer - no prescribed writer present (Writer ID E8132975-6F93-4464-A53E-1050253AE220)

Additionally in your backup job in the backup selection that BMR is not available:

BMR ist nicht verfügbar.png

The Microsoft VSS System Writer is also not displayed in the Writer listing.
You can view the VSS Writer either in PowerShell or in CMD with the following command:

vssadmin list writers

Cause:
The causes of a missing system writer can be very different, so each case must be considered individually.
Please note that a working Microsoft VSS service is the basis for all application consistent backups via TERRA CLOUD Backup.
This error pattern is basically a problem with the operating system itself and not with the backup agent.

Recommendations for action:

  • Please reboot the system and check again the VSS Writer
  • If the Writer is still not present, please check the Windows system event logs for Microsoft error codes
  • Try to back up the system via Windows Server Backup
  • Search with a Windows error code

Recommended Microsoft contribution to this error image:

Missing System Writer Case Explained

Microsoft error code 0x80070018 associated with a missing System Writer

Error pattern:
You will find the error code 0x80070018 VSS Error XML document is too long in the Windows Application Logs.

Recommended Action:
Please check the following article from Microsoft about this error pattern:

VSS Error XML document is too long

Note: The System Writer is a part of the operating system, so we can only give you recommendations. Please contact Microsoft Support to resolve the issue.

Backup, share is automatically included in BMR

Error pattern:
In the job configuration, a network share appears below the "BMR" option, in addition BMR backups fail with VSS errors.

BMR-Option

Recommended Action:
A registry key can be used to exclude a network path from the VSS snapshot, for example
1. windows + R to open the task "Run" and enter them "regedit".
2. navigate to the path HKEY_LOCAL_MACHINE\SOFTWARE\EVault\InfoStage\Agent.
3. add the string named WriterSelectionToIgnore.
4. start the extension with ^
5. add an \ for each \ in the located path.
6. do not forget the * - symbol at the end.

e.g.: ^\\\\Name\\Folder1\\*.*

regedit Eintrag

If no remedy is found after this configuration, it is possible that a service is stored on a network path. To do this, please check the system in question with the PowerShell query:
Get-WmiObject win32_service | select Name, PathName This command checks the storage path of the stored services, these may only be located on locally mounted volumes.

In this case, please also check the Microsoft VSS Writer details for network shares. Instructions on how to read these details can be found here:
Read details of Microsoft VSS Writer

DISK-E-04205 - Error searching for file GLOBALROOT\Device\HarddiskVolumeShadowCopyXY\windows\\systemroot\system32\drivers\*

Error pattern:
DISK-E-04205 Error searching for file GLOBALROOT\Device\HarddiskVolumeShadowCopyXY\windows\\system\root\system32\drivers\%NAME%
DISK-E-04101 Operating system message: The syntax for the file name, directory name, or volume name is incorrect.

Cause:
The entry or reference in the registry indicates a non-existent or incorrect path.

Solution approach:
An adjustment of the path in the registry is necessary, you can find the respective reference under:
Computer\HKEY_Local_Machine\System\CurrentControlSet\Services\%DATEINAMEAUSErrorMESSAGE%

We recommend that you export the corresponding entry before making any changes in the registry.

Often an adjustment to the following entry is sufficient, if necessary you have to check the existing path and adjust the entry specifically:

%systemroot%\system32\DRIVERS\%FILEINAMEAUSERMESSAGE%.sys

After the entry has been adjusted, the system must be restarted to apply the change.

VSS -E-05658 VsscBackup::createSnapshotMap 2 internal error

Error pattern:
You will get the following error image in the log file:

VSS -W-05408 Error adding volume to snapshot set: volume <\?\Volume{GUID}\> <\?\Volume{GUID}\> (BS error: 0x8004230c VSS_E_VOLUME_NOT_SUPPORTED )
VSS -E-05658 VsscBackup::createSnapshotMap 2 internal error
SV -E-09487 GetVolumeInformationW function failed for volume{GUID} (Operating system error: The device is not ready)

Cause:
The Microsoft VSS service cannot create a snapshot for the complained volume because the volume (e.g. a USB stick) is not supported. This can be caused, for example, by the "Entire server" option in the backup set of a file-based backup job, since volumes are included in the backup for which no VSS snapshots can be created. In this case, please remove the option from the backup set and add the volumes to be backed up individually.

The error image regarding the "Entire server" option in connection with a file-based job has already been forwarded to the software manufacturer..

Recommended Action:
Please check which volume it is based on the GUID, you can use the following PowerShell script:

Write-host "Please enter the GUID of the volume(the contents of the curly brackets)"
$GUID = Read-Host
$pattern = "\?\Volume{GUID}\"
$pattern = $pattern.Replace("GUID", $GUID)
Get-Volume -UniqueId $pattern | Select-Object -Property UniqueId,FileSystemLabel,DriveLetter | Out-GridView

File cannot be checked for hard links (Windows\System32\LogFiles\Sum\无ǽ)

Error pattern:
You will receive the following warning message in the log file: "File cannot be checked for hard links: \GLOBALROOT\Device\HarddiskVolumeShadowCopy14\Windows\System32\LogFiles\Sum\无ǽ (OS error (0x2): The system cannot find the specified file)."
Cause:
The operating system cannot check the listed file for hard links due to the special characters.
Solution:
These are standard files of a Microsoft installation, which are not relevant for the function of the server.
Thus, you can delete the \Sum folder (Windows\System32\LogFiles\Sum\) without any problems.
After that, the error will no longer appear in the log file and the backup will thus run through successfully again.

FAILED_AT_FREEZE - VSS_E_WRITERERROR_TIMEOUT)> 0x800423f2

Error pattern:
You will receive the following error message in the log file:

FAILED_AT_FREEZE(0x800423f2 -VSS_E_WRITERERROR_TIMEOUT)

Cause:
A VSS writer times out when trying to bring its application into a consistent state. A cause for this can be performance problems of the system.

Recommended Action: Please follow the usual steps for resolving VSS errors. If the error persists in subsequent backups, we recommend increasing the timeout for the VSS snapshot. The following article explains the increase of the timeout: https://blogs.technet.microsoft.com/asiasupp/2011/08/01/windows-server-backup-failed-to-backup-with-error-0x81000101/

VSS -E-05408 - VSS_E_UNEXPECTED_PROVIDER_ERROR

Windows Agent

Error pattern:
You will receive the following error message in the log file right after starting the backup:

VSS -E-05408 Error adding volume to snapshot set: volume <\?\XY}\> <\\?\Volume{XY}\> (BS error: 0x8004230f VSS_E_UNEXPECTED_PROVIDER_ERROR)
---
VSS -E-05408 error adding volume to snapshotset: Volume <\?\XY}\> <\?\Volume{XY}\> (OS error: 0x8004230f VSS_E_UNEXPECTED_PROVIDER_ERROR)

Cause:
TERRA CLOUD Backup Agent is trying to use an incorrect VSS provider.

Solution:
Please use the following command via CMD or PowerShell to check which VSS providers are stored on the system.

vssadmin list providers

Aufgelistete VSS Provider

The TERRA CLOUD Backup Agent must use Shadow Copy Provider 1.0.

Provided there are other VSS providers on the system, the following REG key can remedy the situation:
The entry ensures that the Shadow Copy Provider 1.0 is used when creating the snapshot for the TERRA CLOUD Backup Agent.
This must be created manually.

Hyper-V Agent

Error pattern:
You will receive the following error message in the log file right after starting the backup:

VSS -E-05408 Error adding volume to snapshot set: volume<\> <\>Volume{XY}\> (BS error: 0x8004230f VSS_E_UNEXPECTED_PROVIDER_ERROR)[Host1]
---
VSS -E-05408 error adding volume to snapshotset: Volume <\?\XY}\> <\?\Volume{XY}\> (OS error: 0x8004230f VSS_E_UNEXPECTED_PROVIDER_ERROR)[Host1]

Cause:
TERRA CLOUD Backup Agent is trying to use an incorrect VSS provider.

Example:
Drittanbieter VSS Provider

Solution:

  1. Determine the provider identifier (provider ID) from the output of the following command: vssadmin list providers
  2. Run the registry editor (regedit)
  3. Take a backup of the affected registry entries.
  4. Delete the corresponding registry key from the following path: HKLM\System\CurrentControlSet\Services\VSS\Providers
  5. Scan the registry for the provider ID and remove all existing references.
  6. Open Component Services by typing "dcomcnfg" at the command prompt.
  7. Open Component Services -> Computer -> COM+ Applications and remove the entry of the third-party VSS provider.
  8. Then restart the affected host.

Note: This customization must be done per affected host!

VSS -E-05616 - 0x8004231f VSS_E_UNKNOWN

Error pattern:
You will receive the following error message in the log file:

VSS -E-05616 snapshot could not be created (OS error: 0x8004231f VSS_E_UNKNOWN (OS error (0x8004231F): unknown error code 0x8004231F))

Cause:
This Microsoft error code can be caused by insufficient free space on a backed up volume or insufficient shadow copy space.

Recommended Action:
Please check via vssadmin list shadowstorage how much shadow copy storage is allocated to the volume and clean up or extend the volume until the free space exceeds that for shadow copy storage.

Test whether you can create a shadow copy by right-clicking on the drive in the Explorer "Configure Shadow Copies..." and creating a shadow copy for the volume with "Create Now". A functional BMR backup via TERRA CLOUD Backup can only be created if all volumes can successfully create a shadow copy.

VSS -W-05408 - 0x80042317 VSS_E_MAXIMUM_NUMBER_OF_SNAPSHOTS_REACHED

Error pattern:
You will receive the following error message in the log file: VSS -W-05408 Error adding volume to snapshot set: Volume <\?\Volume{XY}\> <\?\Volume{XY}\> (BS error: 0x80042317 VSS_E_MAXIMUM_NUMBER_OF_SNAPSHOTS_REACHED)

Cause:
Microsoft VSS allows a maximum of 64 shadow copies on one system. It is not possible to request another shadow copy for the TERRA CLOUD backup, the agent passes on the message of the operating system in the log file.

Recommended Action:
Please check how many shadow copies exist on the system, for this you can enter the following command with administrative privilege in the command line:

vssadmin list shadows

These shadow copies should either be moved to another shadow copy store or deleted.
If another software solution based on Microsoft VSS is used, it should be ensured that there is no overlap between the backup windows.

Recommended Microsoft contributions to VSS

For comprehensive documentation on the Volume Shadow Copy Service, see:

Microsoft VSS Dokumentation

Read details of Microsoft VSS Writer

Each VSS writer is responsible for its own area, e.g. the system status or the registry. With the help of the following instructions, you can find out which directories and folders the respective writers are responsible for. This evaluation can be very helpful when analyzing a VSS problem, e.g. to locate an .exe file on a network share. Please note that "Diskshadow" is only available on server operating systems.

Instruction:

  1. Please open the CMD with administrative permission
  2. Create the "C:\temp" directory
  3. Run the following command "DISKSHADOW /l c:\temp\diskshadow.txt".
  4. Execute the following command "LIST WRITERS DETAILED".
  5. You can find the output in the create "Temp" directory


AFC Logs

AFC stands for Agent Forensic Collector, this tool collects backup and restore log files as well as other important information from a system on which a Windows Agent is installed.
These extensive log files are essential for the diagnosis of many error patterns.

AFC Logs Windows Agent

Download:
You can download the latest version of AFC Tool here:
https://backup.terracloud.de/download/afc.exe

Content and procedure:

  1. Run the afc.exe on the system where the agent is installed

Please select the desired backup job via "Select Job".

  1. Additionally select "Partition Info", "VShadows" and "Installed Applications", as shown in the screenshot
  2. Upload the zip archive to TERRA Drive using the link below, no password is required:
  3. AFC Logfile Upload
  4. Please provide a short upload confirmation to TERRA CLOUD Support


AFC1.png

Note:
The VShadows option is only available on server operating systems.

AFC Logs Hyper-V Agent

Please run the afc.exe on the system where the management component is installed (MGMT Agent).
In the "Custom Forensics" field, enter the path of the installation directory, as in the following screenshot:

AFC2.png

AFC Logs Linux Agent

Download:
You can download the latest version of AFC Tool here:
https://backup.terracloud.de/download/AFCforLinux.tar

For most derivatives, you can use the following command to perform the download:
wget https://backup.terracloud.de/download/AFCforLinux.tar

Collect log files:

  1. Please unpack the script with the following command: tar -xf AFCforLinux.tar
  2. Change via cd to the directory where you have unpacked the script
  3. Check your permissions, depending on the derivative with su or sudo-i
  4. Please change the access rights for the afc_linux.sh script with the command chmod 777 afc_linux.sh.
  5. Then run the script via ./afc_linux.sh

Follow the instruction in the script and specify your support ticket number, alternatively you can specify the order number of the backup package

  1. Optionally you can add files (e.g. screenshots)
  2. The AFC logs can be found in the /tmp/ directory with the name "AFC-< ticket_number >-<hostname>-<YYY-MM-DD-HH-MM-SS>.tar[.gz]".
  3. AFC Logfile Upload
  4. Please provide a short upload confirmation to TERRA CLOUD Support

TERRA CLOUD Backup Portal

Computer / Backup Agent is shown as offline since 01.01.0001

Error pattern:
The computer / backup agent is shown to you in the portal as "offline" since 01.01.0001, although the services of the agent are active.

The error pattern looks identical for the different agents (Windows, Linux, Hyper-V and VMware):

01.01.0001.png

Cause:
The Backup Agent cannot communicate with the portal servers (AMP servers) via TCP port 8087. However, it was possible to register on the Backup Portal via TCP port 8086, otherwise the system would not be displayed at all.

Solution:
Please release the TCP port 8087 to the outside for the system on which the Backup Agent is installed. For more information, see the Network configuration.

Users can only retrieve their own Vault profiles

Error pattern:
You receive the following error message when attempting to register a system with the Vault:

Eigene Vaultprofile.png

Cause:
This error message appears because not all portal servers can access this Vault profile yet.
It can take up to 5 minutes to pass the information to all portal components.
Solution:
Logging in again may speed up this process and thus resolve this error message.

UPDT-E-10320 - Could not upgrade the Agent. The system must be restarted

Error pattern:
You will receive the following message in the Backup Portal after starting the upgrade process: You must restart this computer for the change to the agent software configuration to take effect.

Agent Upgrade Center.png


In BUAgent logfile you can find the following error code for this:
UPDT-E-10320 Could not upgrade the Agent. The system must be restarted

Cause:
A registry key on the system to be backed up prevents the agent from being updated. This key is usually cleared by a reboot.

Recommended Action:
Please check the following article for this, as the procedure is identical:
Pending Restart

Windows Agent

Windows Agent General

No connection between agent and vault

Error:
When adding a vault to a computer, the error message appears that the agent cannot connect to the vault.

Causes:

  • The data entered is not correct.
  • Communication is not possible due to blocked ports.

The following ports must be enabled from the inside out for communication from the agent to the Vault to work:

  • 2546 TCP
  • 2547 TCP (only for replication of the satellite to the basevault).

Review:
Please run the following tests from the system on which the agent is installed:

  • ping backup.terracloud.de
  • ping vault-wmh1-p002.terracloud.de
  • telnet vault-wmh1-p002.terracloud.de 2546

Alternatively via PowerShell:

  • test-netconnection vault-wmh1-p002.terracloud.de -port 2546

(Please use the correct Vault address at this point, see email with credentials)

Solution:
Please check the access data, copy them 1:1 from the email "Your TERRA CLOUD Backup Account".
If the connection attempts fail, please release the corresponding ports.

Native protected data amount differs from actual memory consumption

Error pattern:
The natively protected amount of data is incorrectly displayed in the Backup Portal in the job details or in a report.

Unlimited VSS shadow copy storage:
For each volume shadow copy storage is defined by the operating system, the maximum size can be set either as a total value e.g. 10240MB or "unlimited".
Please check if a fixed and therefore not unlimited shadow copy storage is defined for all volumes.

'Large shadow copy memory:
The size of the shadow copy is included in the calculation of the natively protected amount of data.
Particularly large volumes that are hardly occupied create a discrepancy between the actual amount of data occupied and the amount of data measured by the agent.

'Example of a large volume:
You add a new volume with 1TB capacity to a system that you want to back up. For this volume, 50GB is set aside by default for shadow copies. When backing up the entire volume, these 50GB would be included in the calculation of the native amount of data protected. Please reduce the shadow copy storage for this volume to a much smaller value. If the volume occupancy increases, you can always increase the shadow copy storage.

'Cause of deviation for a large shadow copy memory:
Backup jobs that back up an entire volume, e.g. image jobs or BMR backups also measure the reserved space during the backup, which is released after the backup. You can observe this during the backup as the occupied memory increases for the duration of the backup. The development team of our software manufacturer is already working on an optimization of the measurement timing.

Configuration of the shadow copy memory:
You can make the shadow copy storage via the graphical interface.
The limitation for the System Reserved Partition can only be configured via the properties in the graphical user interface, since no drive letter is assigned for it.

Alternatively, you can also perform the configuration via CMD or PowerShell:

vssadmin resize shadowstorage /for=<drive letter:> /on=<drive letter:> /maxsize=10GB

Example:
vssadmin resize shadowstorage /for=c: /on=c: /maxsize=10GB
vssadmin resize shadowstorage /for=d: /on=d: /maxsize=10GB

Windows Server Deduplication:
This Windows Server role enables deduplication of data on the server. You can see the compressed and deduplicated dataset via the Windows Explorer.
However, the Backup Agent transmits the uncompressed original size of the backup set as meta information.

Please use the following PowerShell command to check if the role is installed on the server in question:
Get-WindowsFeature -Name FS-Data-Deduplication

Should the role be installed:
Please exclude the "Chunk Store" folder below the "System Volume Information" directory from the backup. After the next backup is completed, the measured natively protected data volume should be correct again.

Recommendations:
To determine and analyze the used space on a volume, we recommend, in addition to Windows Explorer, the free tool TreeSize Free.

Invalid file format or delta mapping file is corrupted

Error pattern:
Jun 07 22:15:38 DELT-E-04355 Invalid file format C:\Program Files\TERRA Cloud Backup\Agent\JOBNAME\0000xxxx.DTA
Jun 07 22:15:38 BKUP-E-08196 Your delta mapping file is corrupted. Delete the file, or rename it, and synchronize it with your director. [VV]

Cause:
The error message says that the delta file (0000000X.DTA) or the delta assignment file (0000000X.DTX) is damaged. The delta file contains checksums of the already saved blocks, the delta allocation file is an index file for the delta file. This file is needed so that the agent knows which blocks have already been saved and which are new or have changed.

Solution:
Please perform a backup reset, instructions can be found in the following entry for a very similar error: DELT-E-05782 - Delta file damaged 0000000X.DTA file is damaged: hash mismatch

A value is required for Server0.Password

Error pattern:
A backup fails immediately after startup with the following message in the log files:

PARS-E-05152 A value is required for Server0.Password

Cause:
A configuration file (global.vvc) is missing the hash value for the vault password.
Without this entry, the agent cannot authenticate to the vault system.

Solution:
Please store the Vault password in the Backup Portal again, to do this please go to "Vault Settings" and edit the existing configuration:
See also 2.1.1

DELT-E-05782 - Delta file corrupted 0000000X.DTA file is corrupted: hash mismatch

Error pattern:
You receive the following error message in the log file of a backup job:
DELT-E-05782 C:\Program Files\TERRA Cloud Backup\Agent\Jobname\0000000X.DTA file is corrupted: hash mismatch

The error message says that the delta file (0000000X.DTA) is corrupted, this file contains checksums of the backed up blocks of the last backup.
This file is needed so that the agent knows which blocks have already been backed up and which are new or have changed.

Solution:
Please run the following PowerShell script on the agent system:
Backup Reset Script
Among other things, this script deletes the corrupted delta file and performs a synchronization, in the process the delta file is recreated.
A synchronization can take some time depending on the system size.
After the execution, the encryption password must be entered again.

Illegal function

Error pattern:
The affected system is displayed as "Offline" in the Backup Portal, even though it is in use.
The "TERRA Cloud Backup BUAgent" service is not running:

Auflistung der Terra Backup Dienste

When you try to start the service, you will receive the following error message:

Unzulässig Funktion

Cause:
The "TERRA Cloud Backup BUAgent" service accesses a configuration file (global.vvc) in the installation directory of the agent, among other things, settings for the agent are stored in this file,
that you have configured in the portal (e.g. a bandwidth limit).
With this error pattern, this configuration file is empty, incomplete or corrupted.
Without a proper global.vvc file, the agent cannot back up.

Recommended Action:
For troubleshooting, the global.vvc file in the installation directory can be opened first, e.g. with the editor. In this case the file is empty.

leere Global.vvc Datei

This empty global.vvc can be removed.
After deleting the file you can perform a repair installation of the agent, to do this you need to enter the setup of the agent and select the following option:

Reparaturinstallation

After successful repair installation, the global.vvc file will be filled with content.
Now please store the Vault password again in the Backup Portal, you can find instructions on how to do this under the item "A value is required for Server0.Password"
If the error pattern cannot be solved with these steps, a complete uninstallation followed by an installation of the agent can help, in which the configuration files (including the global.vvc) are downloaded from the vault system and stored in the agent directory.

Hyper-V Server Host BMR Backup

Backing up physical Hyper-V hosts that are actively running VMs has been known to cause problems with Microsoft VSS. Microsoft VSS tries to put the COMPLETE system (including CSVs) into a consistent state.
To enable this, all virtual machines would therefore also have to be paused. Since no VSS snapshot is triggered via the Integration Services via the agent-based backup, there are problems here.

The question generally arises as to why hypervisor servers should be backed up at all.
Enclosed are sample articles from the web:


Individual files and folders can be backed up without problems - only BMR has problems.

For the reason it is also not supported See function overview
With host-based backup from version 8.60 ONLY the VMs can be backed up, not the host itself (also no files and folders).

'We recommend agent-based backup (from within the VM) to take full advantage of the backup solution's features.
Provided a Hyper-V host fails completely, it should be reinstalled and added back to the cluster.

Backup jobs pile up in a queue at

Error pattern:
You see several processes in the queue in the Backup Portal for one system, the current backup job no longer shows any progress.

Recommended Action:
Please restart the TERRA CLOUD Backup services so that the open processes are terminated.

Get-Service -DisplayName "TERRA Cloud Backup*" | Stop-Service
Get-Process | ? ProcessName -Match "VV|VVAgent" | Stop-Process -Force
Get-Service -DisplayName "TERRA Cloud Backup*" | Start-Service


SMTP Prober / Mail Notification

Error pattern:
The Backup Agent does not send mails according to the defined criteria.
You will receive the following or similar messages in the log file of your backup job:

Mailbenachrichtigung.png

Recommended Action:
You can test the stored settings via the Backup Portal. If the test is not successful, you can perform the following steps:

  1. Update the agent to the latest version, as the mail notification feature has been updated to current standards in newer agent versions.
  2. As an alternative to port 25, check port 587 or 465.

Please check once with SMTP Prober Tool if the mails can be sent from the system in general.

SMTP Prober
You can download the tool from the following link: http://www.alexnolan.net/software/SMTPProber.htm
If you can successfully send mails from the system with the tool, it is ensured that the communication with the mail server can be established.

GetVolumeNameForVolumeMountPointW() failed

Cause:
This can happen when database files (MDF or LDF) exist on either a mount point or a symbolic link, rather than in a normal physical location.
Example:
You have your logical location for the database files in C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\DATA, but you have created a symbolic link to the data that exists on another drive:
Pfad muss angepasst werden

Solution:
The location for the MDF and LDF files must be updated.
One way to do this is to detach the database and then attach it again.
If the database is attached, make sure to select the MDF file in the current location (D:\Data\MSSQL\DATA in the above example).
Once the logical reference is updated to the correct path, the backup is successful.

Windows Agent Installation


The installation package is not supported by this processor type

Error pattern:
When installing the agent, you get the following error screen:

Prozessortyp.png

Cause:
The executed setup is not compatible with the used processor type (64 bit or 32 bit).

Solution:
Please use the appropriate setup for the processor type used.

Pending restart

Error:
When installing the agent, you will receive the following message:

Pending Reboot-1.png

Cause:
The operating system creates the "RebootRequired" registry key. TERRA CLOUD Backup Agent checks if this key exists before installation.

HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\RebootRequired

Pending Reboot.png

Recommended Action:
Please perform the reboot before installing the agent, because e.g. recommended Windows updates require a reboot after their installation.

Backup Host Agent Error 0x800706d9

Error pattern:
When registering the system, you will receive the following error message in the Backup Portal

Backup Agent Fehler x800706d9


Solution:

Please check if it is a cluster node with failover cluster role installed it is not a cluster system.

  • If the system is not part of a cluster, please uninstall the Failover Cluster role

The agent checks:

  • If no failover cluster role is installed => Connect to Hyper-V
  • If Failover Cluster role is installed => Connect to the cluster instance


No connection between agent and portal

Error:
When installing the agent on a target system, the agent cannot authenticate to the portal.

Causes:

  • The data entered is not correct.
  • Communication is not enabled due to blocked ports.
  • Ports 8086 and 8087 TCP must be enabled from the inside out.

Review:
Please run the following tests from the system on which the agent is installed:

  • telnet backup.terracloud.de 8086
  • telnet amp01.terracloud.de 8087
  • telnet amp10.terracloud.de 8087
  • telnet amp20.terracloud.de 8087

Alternatively, you can run the following commands in PowerShell:
1 .. 20 | ForEach-Object { Write-Host "amp$(($_).ToString("00")).terracloud.de" : $(Test-NetConnection "amp$(($_).ToString("00")).terracloud.de" -Port 8087).TcpTestSucceeded }
Test-NetConnection backup.terracloud.de -Port 8086

Solution:
Please check the access data, these were defined by you within the backup portal itself.
If the connection attempts fail, please release the corresponding ports.

Agent Upgrade Utility stops working / MAPI job upgrade

Error:
Agent Setup hangs and a window appears with the info "Agent Upgrade Utility stopped working".
Then as soon as you click on "Close Program", a MAPI job upgrade window opens.

Agent Upgrade Utility.png

MAPI-Jobupgrade.PNG

Solution:
Please run the setup again and stop at the first step.

Then download the following .zip file:
Hotfix

Cause ".dll" files are detected as viruses by default in the browser, you will need to unzip the files and then rename them.

libeay32.dll.txt -> libeay32.dll
ssleay32.dll.txt -> ssleay32.dll

  • Now change to Temp directory of the affected system:
  • Open Explorer -> type %temp% in the address bar.
  • There should be a folder named {BD4F2616-B17D-4982-815F-0C78C476839F}.
  • Please now move the two ".dll" files into the directory.


Afterwards the update should be possible over the already started process.

Error 1920 during installation / update of the agent

Error:
During an installation / update of the Windows Agent, one encounters the following message:

1920 Fehler.png

Cause:
There are two possible causes for this:
1. required Visual C++ libraries are not available

2. local port 2548 is blocked by another application
Known applications that cause problems: Dr Tax

Solution:
1. please install the following Visual C++ cumulative update and then run the agent setup again:

https://support.microsoft.com/en-us/topic/the-latest-supported-visual-c-downloads-2647da03-1eea-4433-9aff-95f26a218cc0

2.Use the following CMD command to check if the port is blocked via a running process:

netstat -ano | findstr 2548

Example: TCP --- 0.0.0.0:2548 --- 0.0.0.0:0 --- LISTEN --- 5036

Unless the running process in Task Manager(Details) is then named VVAgent.exe, the port will be blocked.
Subsequently, it must be ensured either temporarily, or better permanently, that the port is open. Once the port is open, the installation / update can be performed successfully.

Windows Agent uninstallation

Error 1722 when uninstalling the Backup Agent

Error pattern:
You will receive the following error message when uninstalling Backup Agent:

Fehler 1722.png

Cause:
The error pattern occurs when agent installation (plug-ins) information is missing from the global.vvc file. Each plug-in adds an entry in this configuration file (e.g. image plug-in).
The error occurs when during uninstallation the entries in this file do not match the plug-ins stored on the system.

Solution:

  1. Please rename the "global.vvc" inside the installation directory to "global.old".
  2. Uninstall the agent afterwards


Agent scripting


PreshutdownTimeout value

If you have a Windows Server 2019 machine in use, separate permissions are required to change the following registry key:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\gpsvc\PreshutdownTimeout

Please make sure you can edit the group policies with the users logged in.

Permissions must be changed
So via "Advanced" please assign permissions to the respective user owner.

Permissions for gpsvc.png
Needed in the case owner permissions.

Owner
After that, you should be able to adjust Registry Key accordingly.

Windows Agent file-based backup


Analysis point in the following path is not traversed

The error message says that you are trying to save a path that is some sort of link.
The actual dataset will probably be on another partition.
This directory was apparently not included in the backup, so the agent does not backup this as well.

Linked hard links were not selected and were not saved

Error pattern:
The backup job completes with warnings "Linked hardlinks were not selected and were not backed up". This warning looks like the following in the log file:

Hardlinks.png

Cause of error:
Hardlinks are files or directories that reference an existing entry in the Master File Table and have the identical properties and contents as the original file. Original file and hardlink differ only in the path. The Configured Backup Set does not include all the hardlinks that exist for the original file and therefore cannot be backed up.

Possible solutions:

  1. Once the entire NTFS partition is backed up, no more linked hardlinks can be faulted.
  2. The backup set can be extended with all existing hardlinks, the required paths can be read out via the command below using PowerShell or CMD.
Syntax : fsutil hardlink list <filename>
Example : fsutil hardlink list c:\list.txt

OneDrive directory cannot be backed up

Error pattern:
A file-based backup job reports the following error in the logfile:
DISK-E-04205 Error searching for file C:\Users\%USER%\OneDrive\*.*
DISK-E-04101 Operating system message: The medium is write-protected.

Solution:
A setting within OneDrive ensures that the agent only sees links to files, as these are only downloaded when needed.
These 0KB files cause the error message, the files must be downloaded once, so that there are no more Verknpüfungen.
In addition, please uncheck the "Files on demand" checkbox, as shown in this screenshot:

One-Drive

SV -W-08372 Exclusion <Exclusion in backup job> is suppressed because it interferes with <Component of BMR backup> BMR selection

Error pattern:
You receive the following error message in the log file of a file-based backup job:
SV -W-08372 exclusion <exclusion in backup job> is suppressed because it affects <component of BMR backup> BMR selection.

Cause:
The configured exclusion would exclude files that are necessary for BMR backup. The backup agent ignores the exclusion to perform a BMR backup.

Recommended Action:
Please remove the offending exclusion from the affected backup job, otherwise the job will complete with a warning for each backup. Modify the exclusion, if needed, to exclude no system-relevant files.

Outlook Offline Data File (OST)

  • .ost files are offline Outlook data files which are automatically created by IMAP accounts, Microsoft 365 accounts, Exchange accounts and Outlook.com accounts.

Since they cannot be moved from one computer to another, there is no need to back them up.

The following registry key excludes *.ost files from the creation of a VSS snapshot by default:
Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\BackupRestore\FilesNotToSnapshot

Ost-Dateien.jpg

Why should *.ost files be excluded from the backup?:
https://social.technet.microsoft.com/Forums/en-US/fc9bebff-9494-4b45-b43d-6b2f8e98add4/oops-windows-7-backup-omits-key-outlook-mail-files
https://support.office.com/en-us/article/find-and-transfer-outlook-data-files-from-one-computer-to-another

More information about files that are automatically excluded from a backup by the operating system:
https://docs.microsoft.com/en-us/windows/win32/vss/excluding-files-from-shadow-copies


It is not recommended to make any changes to the mentioned registry keys..


DISK-E-08235 Operating system error 225, message: The operation could not be completed successfully because the file contains a virus or possibly unwanted software

Error pattern:
You receive the following error message in a file-based backup job log file:

DISK-E-08235 Operating system error 225, message: The operation could not be completed successfully because the file contains a virus or possibly unwanted software.

Cause:
This is a message from the operating system to the agent. Windows Defender is responsible for checking the file.

Recommended Action:
Please check the complained file, in case it is a false report message from Windows Defender, you can release it via whitelist.
Optionally, you can use another antivirus solution to scan the file.

DISK-E-08235 Operating system error 1392, message: The file or directory is corrupted and unreadable

Error pattern:
You will receive the following error message in the log file:

DISK-E-08235 Operating system error 1392, message: The file or directory is corrupted and unreadable

Cause:
The Backup Agent passes on an error message from the operating system that the offending file is corrupted or unreadable.

Recommended Action:
Please check the corresponding file, because this error message is not caused by the backup software.
A system scan via sfc/scannow may resolve the error pattern.
Diagnosis via CHKDSK may also be helpful in this case.

Disable security data processing due to insufficient authorization

Error pattern:

You will receive the following warning message in the log file:

DISK-W-08623 Disable security data processing due to insufficient authorization

Cause:
Compress Advanced Attributes (compress content to save disk space) enabled for at least one directory.

Erweiterte Attribute.png

Solution:
To locate these directories you can run the job once with a different log level. Please edit your job and select the option "Directory" as "Options for log file:". Afterwards, run the backup again, now you should find below the line shown below hints to the directories that cause this. This form of logging generates large log files therefore this type should only be used temporarily. Locate these folders and in Properties->Advanced remove the item "Compress content to save disk space". Afterwards, both TERRA CLOUD backup services should be restarted.

DISK-E-04144 Error opening file [...] $Exported$BCD for input

Error pattern:
You will receive the following warning message in the log file:

DISK-E-04144 Error opening file \GLOBALROOT\Device\HarddiskVolume2\EFI\Microsoft\Boot\$Exported$BCD for input
DISK-E-08235 Operating system error 32, message: Process cannot access the file because it is being used by another process
DISK-E-04144 Error opening file \GLOBALROOT\Device\HarddiskVolume2\EFI\Microsoft\Boot\$Exported$BCD.LOG for input
DISK-E-08235 Operating system error 32, message: Process cannot access the file because it is being used by another process

Cause:
This error pattern is caused by various antivirus software based on Bitdefender. The module "Behavioral scan" in version 6.6.18.265 is responsible.

Solution:
Please update your antivirus software, as this error pattern has been fixed in an update.

UTIL-E-04101 O/S message: The request could not be executed due to an I/O device error

Error pattern:
You will receive the following warning message in the log file:
UTIL-E-04101 O/S message: The request could not be executed due to an I/O device error.

Cause:
The Backup Agent passes on this error message of the operating system in the log file. You can also find this error message in the system event logs under ID 153. This is not a problem with the backup solution.

Recommended Action:
Please check the following Microsoft contribution for this ID.


As described in the Microsoft post, this is a timeout of a request to the storage. For further troubleshooting we recommend the CHDSK tool, for more information see: Microsoft post chdsk

ENVC-E-04096 GetProcessorInfo FindFirstObject failed

Error pattern:
You receive the following error message in the log file of a file-based backup job:

ENVC-E-04096 GetProcessorInfo FindFirstObject failed
ENVC-E-04096 GetBootConfiguration FindFirstObject failed
ENVC-E-04096 GetComputerSystem FindFirstObject failed
ENVC-E-04096 GetOSInfo FindFirstObject failed
ENVC-E-04096 CaptureSystemRestorePointInfo Env Exception: Failed to obtain EnvInfo
BMR -E-08382 BMRCaptureEnvInfo.dll could not be initialized: BMR::CaptureEnvInfoDLL::captureSystemRestorePointInfo(): BMRCaptureEnvInfo.dll DLL failed to capture System Restore Point Info

Cause:
The backup agent cannot retrieve any information of the system (e.g. version of the operating system) via the WMI interface. This error pattern is not caused by the TERRA CLOUD Backup Agent. It may be that the required files are still being accessed by other programs and therefore the information cannot be read.

Recommended Action:
Please check the following query via PowerShell as an example:
Get-WmiObject Win32_Processor

If no output is possible here either, we recommend that you check the Windows Event Logs at this time.

DISK-W-08623 - Disable security data processing due to insufficient authorization

This article was written for the job type "UNC files". For the job type "Local system" there is the following article

Error pattern:
You receive the following warning message in the log file of a UNC job:

DISK-W-08623 Disable security data processing due to insufficient authorization

Cause:
The NAS is not allowing the ACLs to be backed up.

Recommended Action:
Please go to the agent system and open the job configuration:
C:\Program Files\TERRA Cloud Backup\Agent\<JOBNAME>.vvc"
Here you will find the Ignore_Security and Ignore_AltData entries:

Ignore_Security: this switch determines whether the ACLs should be backed up or not. The NAS (e.g. QNAP) does not allow the ACLs to be backed up, so you must set the switch to TRUE.

Ignore_AltData: This switch determines whether the extended attributes should be backed up or not. Provided the Ignore_Security option is set to TRUE, or MAC files are backed up via the job, you should set the switch to TRUE.

Afterwards, both TERRA Cloud Backup services should be restarted.

If the backup job is no longer displayed in the portal after this adjustment, additional characters were probably stored in the configuration file. In this case, please check the <JOBNAME>.vvc with an editor that can display all characters, e.g. Notepad++ (show non-printable characters).

After you have set the options and a backup has been made, be sure to do a test restore.
Since backing up MAC files is not officially supported by our solution, we cannot 100% guarantee that the files can be restored without any problems.

Windows Agent Image Backup


deactivate CBT (Changed Block Tracking)

Instructions:

  1. Stop the two services of TERRA CLOUD Backup Agent.
  2. Please navigate to the installation directory of TERRA CLOUD Backup Agent (default installation path: C:\Program Files\TERRA Cloud Backup\Agent).
  3. Open the file NameOfTheBackupJob.vvc
  4. Add a new switch as described below
  5. Save the file including the changes
  6. Start the two services of TERRA CLOUD Backup Agent

Step 7:
Take a look for the following section in the opened configuration file:

VolumeImageBackup {
SQLServer_Awareness = False
}

Add the following parameter:

VolumeImageBackup {
SQLServer_Awareness = False
EnableCBT = False
}

Effects of this adjustment
By this configuration adjustment the delta detection via the Changed Block Tracking technology is switched off You get a warning in the logfile regarding the adjustment:
is disabled in the configuration file. The entire volume is read for backup. The complete volume read process increases the backup time.

VIMG-W-09841 - CBT (Changed Block Tracking) is not available

Error message:
You will receive the following warning message in the log file:

VIMG-W-09841 CBT (Changed Block Tracking) is not available.

Cause:
The installation of the CBT driver (Changed Block Tracking) requires a reboot, this was not performed at the time of the backup.

Note:
Backing up a system via an image backup job is also possible without the Changed Block Tracking, but the backup duration is much longer.

Solution:
Please perform a system reboot to be able to use the full functionality of the image plug-in.

VIMG-W-09829 - The changed block logging driver fails to log the changes for volume <X>:<volume{XY}>. (State 0, Status 0)

Error message:
You will receive the following warning message in the log file:

VIMG-W-09829 The changed block logging driver fails to log the changes for volume <X>:<volume{XY}>. (State 0, Status 0)

Cause:
The installation of the CBT driver (Changed Block Tracking) requires a reboot, this was not performed at the time of the backup.

Note:
Backing up a system via an image backup job is also possible without the change block tracking, but the backup duration is much longer.

Solution:
Please perform a system reboot to be able to use the full functionality of the image plug-in.

PLGN-E-05905 Could not load <VolumeImagePlugin.dll>

Error message:
You will receive the following error message in the log file. PLGN-E-05905 Could not load <VolumeImagePlugin.dll>
DISK-E-04793 Drive $VOLUMEIMAGE$:\ is not recognized as a persistent mapped drive (drive not found).
DISK-E-04204 Error assigning channel to $VOLUMEIMAGE$:\*.*

Cause:
The backup solution is not able to use the image plugin. Often due to the following causes:

  • The image plugin was forgotten to install after a new installation / re-registration.
  • The image plugin / agent is corrupted.


Solution:
By running the agent setup again, you have the option to perform a change installation. Here you can post-install the image plugin.
Please note that a reboot should take place after the installation of the image plugin.
By re-running the agent setup, you also have the option to perform a repair installation of the agent.

VIMG-E-0449 Volumeimage_plugin::VolumeImageBackupAdapter::getNextBackupObject failed

Error message:
01.ago. 07:18:47 VIMG-E-07966 Job cannot be continued.
01.ago. 07:18:59 VIMG-E-04495 volumeimage_plugin::VolumeImageBackupAdapter::getNextBackupObject failed.
01.ago. 07:18:59 BSTR-E-04144 Error opening file C:\Program Files\TERRA Cloud Backup\Agent\*
01.ago 07:18:59 BKUP-E-04706 Job is forced to fail. [VV]
01.ago. 07:18:59 BKUP-F-04110 Job could not be completed. [VV]

Cause:
The Microsoft VSS service cannot put the system in a consistent state. There are many possible causes e.g.:

  1. On the system to be backed up the "Microsoft Hyper-V VSS Writer" is stored, please note that a BMR backup on Hyper-V hosts is not supported
  2. VSS Writer from third party software are deposited on the system
  3. A path to an .exe file in the registry points to a network share, please note that the VSS service cannot access network shares


Recommendation for action:
Please check the deposited VSS Writers via the command "vssadmin list Writers" and compare them with a system on which an image-based BMR backup is possible.

In addition, we recommend that you read out the details of the VSS Writer and check for a stored network share. The following article describes how to read the details of the Writer:
Microsoft VSS Writer details readout

Error while collecting information about the system provisioning point

Error pattern:
You get the following or similar error image in the log file:

BKUP-E-08235 Operating system error 2, message: The system cannot find the specified file
BKUP-W-08732 Mount point information for system could not be captured. [VV]
BKUP-E-09401 An error occurred while collecting system mount point information. [VV]
BKUP-E-08235 O/S error 2, message: The system cannot find the specified file
BKUP-W-08732 Failed to collect system mount point information [VV]

Recommended Action:
Please run the following command on the affected system:
Mountvol /r
(Removes volume mount point directories and registry settings for volumes that are no longer on the system, preventing them from being automatically mounted and retaining their previous volume mount points when they are added back to the system)

Rebooting the system may also be helpful.

Windows Agent SQL Backup


SQL Express DB backup via SQL plugin fails

Error pattern:
06.ago. 14:08:25 DISK-E-04144 Error opening file \GLOBALROOT\Device\HarddiskVolumeShadowCopy217\Programs\Microsoft SQL Server\MSSQL10_50._SQLEXPRESS\MSSQL\DATA\SQLEXPRESS\%DB%.mdf for input
06.ago. 14:08:25 VSS -E-08102 File backup error (reason: stream backup error) C:_Programs\Microsoft SQL Server\MSSQL10_50._SQLEXPRESS\MSSQL\DATA\SQLEXPRESS\%DB%.mdf component <writer SqlServerWriter (SQL Server 2008 R2:SQLWriter), component %SERVERNAME%\ SQLEXPRESS\ SQLEXPRESS> fails.
06.ago. 14:08:25 CTLG-W-09909 Incomplete backup set metadata. Information for "plugin-specific" could not be retrieved

Cause:
SQL Express instances can only be backed up with the SQL Plug-in as of agent version 8.71. An overview of the supported SQL versions can be found in the release notes.
https://drive.terracloud.de/dl/fiLpZboTGRPeqzW1cqwS6yin/Documentation_and_Release_Notes.zip

Solution:
Please update the agent version to 8.71 or higher.

SQ12-E-09295 A successful full backup has not yet been made of database XY.

Error pattern:
You receive an error message in the log file that no successful backup could be created from a database:

SQ12-E-09295 A successful full backup has not yet been made of the database database name.

Cause:

The MSSQL VSSWriter service runs under a system account.

Recommendations for action:

  • The MSSQL VSSWriter service should be changed to an ActiveDirectory account with administrator privileges.


SQL Backup Jobs cannot be edited after credentials change

Solution:
Make a backup copy before changing the files!
1. create a new SQL job with the new Windows credentials.
2. you will find the file "JOBNAME.vvc"
in the installation directory of the agent. 3. copy the paragraph "WindowsCredentials" from your test job to the .vvc of the correct backup job

Subsequently, the backup process could be continued.

No instance list could be provided by the agent

Error pattern:
You get the error message on the following screenshot when you try to create a new SQL backup job via Backup Portal:

Instanzliste-SQL.jpg

Cause:
The agent cannot connect to the SQL instance. Possible causes are:

  1. There is no SQL instance installed on the system

The installed SQL instance is not supported by the SQL plug-in, e.g. because it is not a Microsoft SQL instance. Recommended Action:
Please check the latest Release Notes for the Windows Agent to see if the installed instance is supported.

You are shown the databases of a named instance, although you have selected "Standard" as instance

Error pattern:
When setting up a new SQL backup job, or editing an existing job, you are not shown the databases of the MSSQL instance. Additionally, you may not be able to log in with the SQL credentials of the user of the MSSQL instance, even though you have selected the default instance.

Cause:
If you select Standard as the instance in the Backup Portal, the instance for which the port 1433 is assigned is checked in the background. If this port is assigned to another instance, this instance will be displayed or you will be asked to authenticate for it.

Solution option 1:
If possible, reassign port 1433 to the default instance.

To do this, open the SQL Server Configuration Manager

  1. Select the menu item SQL Server Network Configuration -> Protocols for MSSQLSERVER -> TCP/IP -> IPALL

Port 1433 should be set for this option, as shown in the following screenshot

Port 1433.jpg

Solution option 2:
If solution option 1 is not possible, we recommend that you implement the following steps:

Please check the Connection String first:
1.open Notepad
2.Please add the following 3 line to the text file. <hostname> stands for the hostname of your SQL server;<port_number> is the assigned port of the default instance

     set db = CreateObject("ADODB.Connection") 
db.open "Driver={SQL Server};Server=<hostname>,<port_number>;Database=;"
MsgBox(db.Provider)

3.save the text file as e.g. "test_db.vbs".
4.run the created script

After verifying the connection, please make the following adjustment in the SQL server registry:
1.open the registry
2.Navigate to "HKEY_LOCAL_MACHINE\SOFTWARE\EVault\InfoStage\Agent\"
3.create the entry "ADOConnectionStrings" as "REG MULTI SZ" add
4.add the following key to the created entry

     <hostname>="Driver={SQL Server};Server=<hostname>,<port_number>;Database=;" 

An example would be: "SQL01="Driver={SQL Server};Server=SQL01,1434;Database=;" In this example, SQL01 is the host name and 1434 is the assigned port.

After customization, you will see the correct instance in the Backup Portal if you select "Default".

Windows Agent Exchange Backup


Circular logging

Circulation logging is currently enabled. It is better to disable it in production environments. "Circulation logging is not recommended for production environments.
Source: https://technet.microsoft.com/de-de/library/bb331968%28v=exchg.80%29.aspx
The above link also describes how to disable circulation logging on an exchange server.
An informative article on the subject of circulation logging:
http://www.itadministrator.de/themen/kommunikation/123111.html
Alternatively, you can also disable the backup of transaction logs. Then only the Exchange database is backed up, transaction logs are left out.

Customization target mount path for Granular Exchange Restore

By default, it is mounted below C:\RestoreMount. Unless there is enough space on the disk, another drive letter must be used.
The registry key below can be used to customize the destination path.

Solution:
Create the following registry entry with a string:
HKEY_LOCAL_MACHINE\SOFTWARE\EVault\Infostage\Agent\MountAlternatePath=

No restart of the backup service is required.

Example:
HKEY_LOCAL_MACHINE\SOFTWARE\EVault\Infostage\Agent\MountAlternatePath=e:\mp

When e:\mp is used as a string, the release: \EX2007SERVER\e$\mp\GRT_000010_2013-06-25-10-13-43
Alternativer Pfad

Note:
Only possible with Granular Restore Tool 8.x or higher.

Validation failed for Exchange database Mailbox Database XYZ, reason: Timed Out

Error pattern:
You receive the following error message in the Exchange backup log files: EX10-F-10379 Validation failed for Exchange database Mailbox Database XYZ, reason: Timed Out

Cause:
Checking the database via the ESEUTIL takes too much time, this can be attributed to a heavy workload or too low performance of the system.

Recommended Action:
Please set the following registry entries to increase the timeout of the check and adjust the flow of the check (sequential):
HKEY_LOCAL_MACHINE\SOFTWARE\EVault\InfoStage\Agent\Ex2010SequentialValidation = 1 (DWORD)
HKEY_LOCAL_MACHINE\SOFTWARE\EVault\InfoStage\Agent\Ex2010ValidationTimeOut = 18000 (DWORD)

Restart both TERRA CLOUD Backup services and try to start a backup again including a database check.

Windows Agent Oracle Backup


The credentials for the plug-in could not be verified due to an unexpected error. Verify that the credentials are correct and try again

The Oracle plug-in uses the connection to the Oracle database EZCONNECT. Make sure that your configuration in the sqlnet.ora file is correct.
E.g.:
# SQLNET.ORA Network Configuration File: d:\oracle\ora92\network\admin\sqlnet.ora
# Generated by Oracle configuration tools.
SQLNET.AUTHENTICATION_SERVICES= (NONE)
NAMES.DIRECTORY_PATH = (EZCONNECT,TNSNAMES)

Start Oracle listener and try again with a backup.

Hyper-V Agent

Hyper-V installation of Visual C++ 2017 Runtime(64) failed

Error pattern:
You receive the following error message in Setup during Hyper-V Management Agent installation:

Hyper-V-Agent-Installation.jpg

Cause of error:
As already described in the error message, there was a problem with the runtime download. This error pattern occurs only sporadically.

Solution:
You can either cancel the setup and perform the installation again including the download of the runtime or download and install the runtime manually.

You can download the current runtime from the following link:
https://aka.ms/vs/16/release/vc_redist.x64.exe

For more information, please visit:
https://support.microsoft.com/de-de/help/2977003/the-latest-supported-visual-c-downloads

Hyper-V VM is backed up by other process

Error code:
AGCD-E-10348 Virtual machine "XXX" ["VM-ID"] could not be backed up because it is currently being backed up by another process.

Cause:
Here, no backup of the VM's can be performed because of leftover files due to an update of the Hyper-V Host Agent from version 7.x to version 8.60,
which are misinterpreted during the backup request.

Solution:
Please change to the following directory and remove all files located there:
C:\Windows\System32\config\systemprofile\AppData\Local\EVault Software\Agent Worker\Notifications Queue\

Note:

 First, please update to the latest version of the Hyper-V Agent, as this error pattern has been fixed in version 8.84.1309. 


Hyper-V unknown exception

Error message:
"unknown exception" in back supportal during configuration/setup
unbekannte Ausnahme
Cause:
Here, no backup of the VM's can be performed because of leftover files due to an update of the Hyper-V Host Agent from version 7.x to version 8.60,
which are misinterpreted during the backup request.

Solution:
Please change to the following directory and remove all files located there:
C:\Windows\System32\config\systemprofile\AppData\Local\EVault Software\Agent Worker\Notifications Queue\

Note:

 First, please update to the latest version of the Hyper-V Agent, as this error pattern has been fixed in version 8.84.1309. 


Hyper-V backup shows no progress

Error code:
A previously working backup starts after the update to 8.60, but no progress is apparent.
Sicherung scheint zu hängen
Cause:
Here, no backup of the VMs can be performed because of leftover files due to an update of the Hyper-V Host Agent from version 7.x to version 8.60,
which are misinterpreted during the backup request.

Solution:

  1. Stop the agent services of the MGMT agent and all host agents
  2. Please change to the following directory (step 3) and remove all files located there:
  3. C:\Windows\System32\config\systemprofile\AppData\Local\EVault Software\Agent Worker\Notifications Queue\
  4. Please restart the agent services of the MGMT and all host agents.

Note:

 First, please update to the latest version of the Hyper-V Agent, as this error pattern has been fixed in version 8.84.1309. 


Hyper-V FAILED_GeneralFailure

Error message:
The backup job of a Hyper-V agent aborts right after startup and deposits the following error message in the log file:
AGCD-E-08383 VSS snapshot operation completed with result 'FAILED_GeneralFailure

Cause:
In this case, there is a VSS integration failure between the host and VM.

Recommended Action:
1. please remove the following option in the integration services of the VMs to be backed up and confirm with "OK":

Hyper-V VSS.png

2. lead start a backup afterwards, this backup should fail due to the lack of VSS support via the integration services.

3. please re-enable this option for all system and try to backup again.

Note:

 First, please update to the latest version of the Hyper-V Agent, as this error pattern has been fixed in version 8.84.1309. 

Hyper-V backups are no longer started via the schedule

Error pattern:
The Hyper-V Agent no longer starts a backup via the schedule.

Solution:
Please store the encryption password again in the backup job in which you edit the job.

Hyper-V update from 8.60 to 8.X fails

Error message:
You receive the following error message during the update installation of the management and host components of agent version 8.X:

Error 1316.The specified account already exists.

Error1316.png

Cause:
One registry entry each for the MGMT and the host components is incorrect and prevents the update from 8.60 to 8.X.

Solution:

  1. Please open the registry on the systems on which the individual components are installed
  2. Search for the following GUID of the MGMT agent 27FB23FA45CDCCA419AFA539FAB44906 and click on the folder "SourceList".

Change the value of the PackageName key to TERRA Cloud Backup Hyper-V Agent Management.msi and save it.

  1. Search the registry of the systems on which the Host Agent is installed for the GUID 2BFC6FB3019E15D449DEFDFA7BA62BA0
  2. Navigate to the "SourceList" folder and change the value of the "PackageName" key to TERRA Cloud Backup Hyper-V Agent Host.msi and save it
  3. After that you can perform the update

Linux Agent

DISK-F-04144 Error opening file /var/lib/lxcfs

Error pattern:
You receive an error message in the log file of a Linux BMR job that files below the /var/lib/lxcfs/ directory cannot be backed up due to lack of permission.

Cause:
It is a FUSE file system for the use of Linux containers, within this system the root user does not have the necessary permissions.

'Further information on the subject:
https://ubuntu.com/blog/introducing-lxcfs
https://linuxcontainers.org/lxcfs/introduction/

Recommended Action:
Since this directory is not necessary for a BMR restore, you can remove this directory on the backup job. After exclusion, the error message no longer appears.

Exklusion lxcfs.jpg

Delta file not found / damaged

Error pattern:
You will receive the following error message in the log file:

BSTR-E-04166 File not found /opt/BUAgent/localjob/0000XY.DTA BKUP-E-08194 Delta file is missing. Synchronize the job to recreate the delta file. [VV]

In case of a corrupted delta file, the error pattern looks very similar.

Cause:
The agent cannot access the delta file because it either does not exist as in the example above or is corrupted and the stored checksum of the file does not match the one currently measured.

Solution:
On the protected system, check in the agent directory if there are .DTA and .DTX files in the job folder, if not you can start a synchronization of the job in the Backup Portal.
If there are files, please remove them via rm DATEINAME or e.g. via WinSCP. Please start a synchronization of the job afterwards.


An additional process starts during a backup/restore/synchronization

Error pattern:
When a Linux backup job is executed, a second "empty" process starts.

On this screenshot you can see an "empty" process that is still active after two other processes have finished.

Note:
This error pattern has already been passed on to the software manufacturer; it is merely a display error, since there is no process with the displayed process ID on the corresponding system.

Leerer Prozess Linux.png

Linux system is displayed as "Offline" in the portal

Error pattern:
In the Backup Portal, a Linux Agent is displayed as "Offline" even though the backed up system is active and backups are still being performed.

Cause:
The "VVAgent" service is no longer working correctly or has stopped.

Solution:
On the system in question, run the following command, for example, to restart the service:

/etc/init.d/vvagent restart

Alternative:

systemctl restart VVAgent

BMR -E-07393 Unknown message: ID = 10596 Parameter0 = /Bare_Metal_Restore_Image.iso

Error pattern:
You receive the following error message in the log file of a BMR Linux job:
BMR -E-07393 Unknown message: ID = 10596 Parameter0 = /Bare_Metal_Restore_Image.iso

If you have configured the language in the Backup Portal to English, you will receive the following error message:
BMR -E-10596 The backup agent cannot find the ISO image at the user configured location {1}.

Cause:
The system to be backed up does not have Relax and Recover version 2.5 installed.
Please note that currently only the version 2.5 is supported.(As of January 2021)

Recommended Action:
Please check the installed version first via the following command:
rear-V

If the version is lower than 2.5, you can update it to 2.5. In the case of a newer version, you would need to downgrade in the form of uninstalling and reinstalling version 2.5.

For more information and guidance on rear, please visit:
https://relax-and-recover.org/documentation/

VMware vSphere Recovery Agent

VSPH-W-10566 Failed to verify SQL Server transaction logs were truncated for instance ESXI-SQL on VM {1}.

Error pattern:
You receive the following warning message in the log file during a backup job of a vSphere Recovery Agent version 8.82 or later:

VSPH-W-10566 Failed to verify that SQL Server transaction logs were truncated for instance ESXI-SQL on VM {1}.

Cause:
The vSphere Recovery Agent cannot check if the transaction logs are truncated on a German SQL installation. Presumably, this error pattern occurs with all non-English installations.

Recommended Action:
Please change the setting for truncation of transaction logs to "Backup with copy only" (see screenshot).

Sicherung nur mit Kopie.png

The transaction logs can be optinally truncated via board means of Microsoft SQL. Alternatively, you can install a Windows agent including SQL plug-in in the VM and protect the database via an SQL backup job. In this scenario, you back up the system via a host backup and the database additionally via an application-consistent agent backup.

VSPH-W-10274 Virtual machine "Name of VM" could not be suppressed. The backup will try a crash consistent snapshot instead

Error pattern:
You will find the following error message in the log file: VSPH-W-10274 Virtual machine "Name of VM" could not be suppressed. Backup will attempt a crash consistent snapshot instead.

Cause:
The vSphere Recovery Agent cannot stop the file system inside the VM through vCenter because the Quiesce guest file system feature is not available.

Recommended Action:
Please check if the option shown below is available in vCenter when creating a snapshot. Verify that VMware Tools are installed and up to date within the VM. If you are still unable to use this feature, please contact VMware Support as it is an issue with the hypervisor.

Snapshot erstellen.png

VSPH-I-10525 An old version of VMware tools is installed on VM XYZ. Update the VMware tools to the current version

Error pattern:
You will receive information in the log file that the installed VMware tools on a VM are outdated and thus no application-consistent backup can be created.

Cause:
For an application-consistent backup, the Microsoft VSS components must be addressed within the VM. To use this feature, at least version 11 or higher must be installed.

Recommended Action:
Please check the version number of VMware Tools e.g. in vCenter and update it.

An example, after the update an application consistent backup is possible.

VMware Tools.png

For more information, see the latest documentation of the vSphere Recovery Agent.

TERRA CLOUD Backup Satellite

Backup "Job cannot be registered to the Vault. It may already exist in the Vault." (Only in connection with a satellite)

Cause:
As long as the satellite is set to "Bypass inactive", a computer or a backup job cannot be registered directly to the Basevault, because the Basevault is set as the current backup destination in the Vault settings.

Solution:
Please store the local IP address of the satellite in the Vault settings and try to create the job or add the computer again.

Time in satellite is not correct

Causes:
The bandwidth limitation adheres to the receiving time. If the time is out of sync, the plan will not work correctly.
Solution:
Please share port NTP port 123/UDP from satellite to internet.

BMR recovery

Checklist troubleshooting BMR recovery

General:
In the event of an error, please go through the following checklist during or after a BMR recovery.
Based on the answers, the error pattern, if not already covered by the Troubleshooting Guide, can be narrowed down.
Furthermore, the checklist enables a faster and more efficient support process.

Checklist:

  1. Is this a production restore or a test restore?
  2. When was the last time the system was restored in a test recovery?
  3. Which version of the Restore ISO was used? → Please always use the latest version.
  4. Have you restored a file or image based backup job?
  5. Does the problem occur while configuring the backsight? If YesPlease check the procedure in the documentation for this.
  6. Have you already saved log files of BMR backups? If noA for this you find instruction under Save logfiles of a BMR backups
  7. Successful recovery to a physical or virtual system? If virtualwhat virtualization technology is used?

Is the source system a BIOS or UEFI installation? → The firmware used decides the VM generation, e.g. for Hyper-V.

  1. Have you restored all volumes or only those necessary for the operating system?
  2. Were different backup points/safesets already selected for the restore?
  3. What is the role/purpose of the source system? → e.g. DC, MS-SQL, file server etc.

Tips:
A faulty production restore causes a stressful situation and downtime should be kept as short as possible. The following tips can simplify the fault clearance process and save valuable time.

Parallel recovery:
You can restore simultaneously from the primary and secondary Vault and, if necessary, a satellite. This provides you with backups from at least two sources at the same time.
The FQDNs and Public IPs can be found in the Vault overview.

Pursue multiple solution paths simultaneously:
Example:
After restoring the latest safeset, the system booted into a blue screen because there was operating system corruption at the time of the backup.
In this scenario, you could restore two older safesets from, say, three days ago and the end of last month at the same time, using Parallel Restore.
This strategy doubles the chances of hitting a backup point that contains the system's data before the operating system is corrupted.

Recovery in a disaster recovery VM:
The TERRA CLOUD offers you the possibility to provide a virtual machine or a virtual disaster recovery environment in a fully automated way.
Take advantage of this offer to initiate a secondary recovery into a completely new environment based on Microsoft Hyper-V, in addition to the primary recovery debugging.
If recovery to the original system/environment is not possible, restoring to a DRVM may increase the chance.

'Documentation of the recovery:
Please attach screenshots of error messages/incorrect behavior directly to a support ticket or request. By providing documentation in the form of the checklist and screenshots, you shorten the information gathering part of a support ticket.


System boots into a boot error/bluescreen/blackscreen after a restore

Error pattern:
After a successful BMR restore, the system displays a boot error after startup, such as the following:

BSOD.jpg

Procedure:
Please go through the Checklist Troubleshooting BMR Restore first and provide the results to support if necessary.

Recommended actions:
Please check if you can work around the error with the following instructions.

BMR operating system volume restore:

  1. Run the BMR restore again and restore only the volume for the operating system
  2. Check if the system can boot after successful recovery
  3. Provided the system can boot, install a Windows agent in the system and register it in the portal
  4. Restore the remaining volumes via the Backup Portal, e.g. via restore from another computer

Save log files of a BMR backup

General:
To debug a BMR recovery, it may be necessary to access detailed recovery log files. The recovery software offers three different levels of detail for the log files in the settings:

  • DEBUG
  • LOG WARNING
  • LOG ERROR

The "DEBUG" option offers the highest level of detail and is thus best suited for troubleshooting. However, there is often a problem that the log files are discarded by the reboot after the failed recovery or cannot be saved outside the system beforehand.

Best practice for providing log files of a BMR back-up:
The following instructions show you a recommended way to save log files for debugging a BMR back-up and make them available to TERRA CLOUD Support.

The log files must be stored outside the storage area relevant for the restore. This can be done on a network share or a local volume.

Debug-log.jpg

Network sharing procedure:
Please restart the recovery for debugging and select the log level "DEBUG" in the settings under "Log Settings". You can store your network share as the storage destination. After the restore, please send the saved log file to TERRA CLOUD Support.

Procedure "Local Disk":
Please provide the target system with another volume of at least 20 GB, as the log files can become very large depending on the size of the recovery. If this is not possible, e.g. because it is a physical server, we recommend booking a disaster recovery VM in the TERRA CLOUD including an additional VHDX for the log files.

You can set up the additional hard disk from the command prompt in the main menu of the recovery software using Diskpart. In the following screenshot, Notepad has been opened from the command line to show the volume set up via Diskpart:

Debug-vhdx.jpg

After that, please navigate to the settings under "Log Settings" and select the log level "DEBUG". You can then select the extra volume set up as the storage destination. After the recovery is complete, please provide the saved log file from the volume to TERRA CLOUD support.

Failed to GetDiskDetails

Error pattern:
During a BMR recovery you will receive the following error:
Failed to GetDiskDetails

Cause:
The Restore ISO is not able to process the job details from our Vault.

Solution:

Note:
In this case, if it is a disaster recovery VM within the TERRA Cloud, the required RestoreAPI_IS.dll is already stored for you in the ISO.
You can proceed directly to step 2 and start the recovery.

Step 1:
Please paste the following file into the restore iso, you can use the following software for this.

Step 2:
Start the recovery with the edited ISO.

Step 3: Select the language German, then open the menu item Command Prompt and proceed as follows:

  • Type "taskmgr" to open the task manager. Then close the "Carbonite Server Backup System Restore Main..." process.
  • Next, enter the following commands in the X:\Windows\System32\RestoreApp> path:
  1. del RestoreAPI_IS.dll
  2. copy D:\RestoreAPI_IS.dll . (Note partition name of ISO file, test if necessary. By default D:\)
  3. RestoreApp.exe


Step 4: Afterwards, perform the recovery.

Device Manager failed to get current information

This error message appears after the password for the Restore Point backup job is entered.
System Restore Wizard
Device Manager failed to get current information

Solution:
The SCSI controller driver from "Paravirtual" must be changed to "LSI Logic SAS".

Restore BIOS system on an EFI system

Error pattern:
You will receive the following error message in "Step 3 Map Volumes" during recovery:

You cannot drag the volume to this position because the new order of partitions would violate Microsoft Rules.
The partitions schould be in the following order: Recovery (if any), ESP(if any), MSRP and then primary data partition(s).
Please delete all partitions on this disk and try again.

BMR Restore-Fehlerbild GEN1 in GEN2.png

Cause:
You see in the screenshot the error image that a Hyper-V GEN1 VM (BIOS) should be restored in a Hyper-V GEN2 VM (UEFI). This is not possible due to the different firmware of the two VM generations.

Solution:

Hyper-V:
Create a new VM in the same generation as the source system (in the example above, a GEN1 VM should be created for recovery).

VMware:
You can create a new VM via the vCenter or the Host Client and decide via the "Firmware" option whether EFI (Required for GEN2 VMs) or BIOS (Required for GEN1 VMs) is to be used. is to be used for the VM.

In the following screenshot you can see the creation process of a VM in vCenter:

VMware Generation.png

'TERRA CLOUD IaaS VM:
You can decide if a GEN1 or GEN2 should be deployed when ordering an IaaS VM just before the configuration is complete, this generation must again match the firmware or generation of the source system.

Alternative solution:
Restoring a BIOS system to a UEFI system is possible, but not recommended.
To do this, convert the target volumes for the system partition to GPT (by right-clicking on the disk icon) and drag only the system partition from the source to it.
The Microsoft System Reserved partition does not need to be dragged from the backup to the target, only other data partitions if present.

Restore EFI system to a BIOS system

Error pattern:
You will get the following error message in "Step 3 Map Volumes" during recovery:

an EFI System partition can only be restored to a System using UEFI not a BIOS system

Restore von GEN 2 in GEN 1.png

Cause:
You see in the screenshot the error image that a Hyper-V GEN2 VM (UEFI) should be restored in a Hyper-V GEN1 VM (BIOS). This is not possible due to the different firmware of the two VM generations.

Solution:

Hyper-V:
Create a new VM in the same generation as the source system (in the example above, a GEN2 VM should be created for recovery).

VMware:
You can create a new VM via the vCenter or the Host Client and decide via the "Firmware" option whether EFI (Required for GEN2 VMs) or BIOS (Required for GEN1 VMs) is to be used. is to be used for the VM.

In the following screenshot you can see the creation process of a VM in vCenter:

VMware Generation.png

'TERRA CLOUD IaaS VM:
When ordering an IaaS VM, you can decide shortly before the configuration is completed whether a GEN1 or GEN2 should be provided, this generation must again correspond to the firmware or generation of the original system

Bootable Media Creator

Creating a bootable USB stick fails with error code 1

Error pattern:
You get the following error when you try to prepare a bootable stick with Bootable Media Creator:
BMC - Error1.png

Cause:
This error pattern only occurs on systems that are not installed in English.
We have already forwarded this to our software vendor to extend support for additional languages.

Solution:
Please create the ISO locally first. You can create a bootable stick via the software Rufus.


If you have any further concerns, please do not hesitate to contact us by email (support@terracloud.de) or by phone at (-850).
Your TERRA Cloud Team