Troubleshooting Guide: Difference between revisions

From SEPsesam
(Marked this version for translation)
(80 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages />
<translate><!--T:1-->
{{Copyright SEP AG en}}
{{Copyright SEP AG en}}
== Introduction ==
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3/4.4.3 ''Beefalo V2'']]|link=[[Special:MyLanguage/SEP_sesam_Documentation#previous|documentation archive]]}}</translate><br />
This guide is intended to help you quickly identify and resolve problems and errors during setup, installation and normal operation of your SEP sesam system. SEP sesam often serves as an indicator that there has been a change or event that impacts overall system performance. Changes in SEP sesam backup performance are often caused by system changes or failures.
<translate>==Introduction== <!--T:2--></translate>
 
<div class="boilerplate metadata" id="Additional resources" style="background-color:#ecedf1; color:#8695a7; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 35%; "><center><b><translate><!--T:3-->
SEP sesam provides two guides to help you resolve any problems you may encounter:
Additional resources</translate></b></center>
 
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
* The ''[[Error Messages Guide]]'' lists error messages alphabetically, provides explanations of the errors wherever possible and suggestions for correcting the problems. Such messages contain an error number that can be used to access this information.
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:4-->
 
[[File:SEP_next.png|45px|link=Special:MyLanguage/Error_Messages_Guide]]</translate>
* The ''Troubleshooting Guide'' describes problems as they may arise during the operation of your SEP sesam system, lists possible causes wherever possible and provides solutions to the problems.
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:5-->
 
See also: [[Special:MyLanguage/Error_Messages_Guide|Error Messages Guide]]</translate>
{{First steps}}
== How to interpret SEP sesam's backup module's error messages? ==
SEP sesam backup modules are designed to produce extended error messages which may return information from 5 layers: SBC – XBSA – FTP – SMS – operating system. SEP sesam scans the protocol files for warnings and errors after backup and restore. In the event of a warning or an error, the first identified message is printed in the summary at the end of the protocol.
 
Every backup module uses the X/Open Backup Services API (XBSA) standard. ''SEP sesam XBSA'' is based on ''FTP'' implementation. The backup module connects to SEP sesam's FTPD daemon implementation – '''''Sesam Transfer Protocol Daemon (STPD)'''''. STPD is a service that requests and delivers the backup data from or to the SMS Server and manages the data flow between the SEP sesam Server and a client. During a restore STPD receives the data from the SMS Server and sends it to the client, which then restores the data to the target system. '''''Sesam Multiplex Stream (SMS)''''' is a service that receives the backup data from STPD and writes the data to the backup media. During a restore, it reads the data from the backup media and sends it to STPD. Additionally, the ''SEP sesam backup client (SBC)'' module executes backup, migration and restore tasks. SBC collects and consolidates backup data on the client system and delivers it to STPD. A list of all SBC messages (C header file) can be found at [[SBC Messages]].
 
An error message is composed of the messages from the triggering layer up to the upper layers. If an operating system returns an error, the error code and the operating system message are added to the SEP sesam error message. Because of this, error messages can also help troubleshoot problems that are not caused by SEP sesam (for example, OS problems).
=== Typical backup protocol ===
The following example shows a '''typical backup protocol'''. It is composed of 4 sections: ''about module'', ''operational parameters'', ''processing'', and a ''summary''.
 
2009-06-26 10:28:16: sbc-3036: Info:    # SESAM BACKUP CLIENT FOR Windows NT FILE SYSTEMS, VERSION: 3.2A17 Build
Revision: 1.257 (x64), Released: Jun 25 2009 #
2009-06-26 10:28:16: sbc-3063: Info:    -------------------- Operation Parameters --------------------
2009-06-26 10:28:16: sbc-3019: Info:    OS info:          Microsoft Windows Server 2008, Build: 6001 Service Pack 1 (x64)
2009-06-26 10:28:16: sbc-3100: Info:    Program PID:      42900
2009-06-26 10:28:16: sbc-3030: Info:    Operation:        BACKUP, Level: COPY
2009-06-26 10:28:16: sbc-3031: Info:    Storage Host:    qsbox3:11001,0-0:SESAM_SECURE_AUTHENTICATION:****
2009-06-26 10:28:16: sbc-3032: Info:    Control Host:    qsbox3:11001:SESAM_SECURE_AUTHENTICATION:*
2009-06-26 10:28:16: sbc-3040: Info:    Device:          SMS:disk1:SHARE:64
2009-06-26 10:28:16: sbc-3064: Info:    --------------------- Operation Messages ---------------------
2009-06-26 10:28:16: sbc-3002: Info:    Building file list from: [C:\SEPsesam\var\ini]
2009-06-26 10:28:16: sbc-3022: Info:    Command line ["sbc" "-b" "-C" "qsbox3:11001" "-S" "qsbox3:11001" "-l" "copy" "-s"
"SF20090626102812" "-d" "SMS:disk1" "-t" "weekly00001:1" "-j" "TEST_BACKUP" "-i" "job=TEST_BACKUP,nod=qsbox3,cmd=sbc,src=C/ /SEPsesam
/var/ini,ptf=WNT,typ=Path,exc=" "C:/SEPsesam/var/ini" ]
2009-06-26 10:28:16: sbc-3003: Info:    Opening saveset: SF20090626102812
2009-06-26 10:28:18: sbc-3104: Info:    Saveset info: [SEGMENT=3]
2009-06-26 10:28:18: sbc-3004: Info:    Begin writing to saveset...
2009-06-26 10:28:18: sbc-3074: Info:    Backup start time [20090626102818]
2009-06-26 10:28:18: sbc-3143: Info:    Starting with drive C:
2009-06-26 10:28:18: sbc-3006: Info:    Saveset size: 98304 bytes. Throughput: 189.820 MB/Hour.
2009-06-26 10:28:18: sbc-3005: Info:    Closing saveset.
2009-06-26 10:28:18: sbc-3052: Info:    Items processed correctly: [25]. Not processed or incorrectly processed items: [0].
2009-06-26 10:28:18: sbc-3007: Info:    Operation successful.
2009-06-26 10:28:19: sbc-3001: Info:    Exiting.
 
=== Backup error summary ===
The error message summary is prefixed by a short information string. The full error message is composed as follows:
 
{status}/{amount}/{save set ID}/{SBCstart}/{message}
 
The components of this string have the following meanings:
 
{| class="wikitable"
|- style="text-align:center;"
| style="width: 21%" | '''{status}'''
| style="width: 21%" | '''{amount}'''
| style="width: 23%" | '''{save set ID}'''
| style="width: 18%" |'''{SBCstart}'''
| style="width: 17%" |'''{message}'''
|- style="vertical-align:middle; text-align:left;"
| scope="row"|
'''0''' - ''successful''<br>
'''1''' - ''warning''<br>
'''2''' - ''empty LIS''<br>
'''3''' - ''broken during backup''<br>
'''C''' - ''broken before data transfer''<br>
'''X''' - ''failed''
| Amount of data stored on media
| Automatically generated save set ID
| Starting time on the client
| Message about the error
|-
|}
|}


The following example shows a backup error summary with all 5 layers prefixed by a short information string.
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
X/0/SF20060629233007/20060629232907/Error: XBSA Call BSAEndData (closing saveset) failed:
| rowspan="2" style="padding:0px 10px 0px;" |  
System detected error, operation aborted. TRANSIENT or PERMANENT NEGATIVE reply:
<translate><!--T:6-->
553 STOR Failed. 1037: Writing data block on tape failed (23): Data error (cyclic redundancy check).
[[File:SEP Tip.png|45px|link=Special:MyLanguage/FAQ|FAQ]]</translate>
1039: Writing of Saveset Trailer failed.
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |  
 
<translate><!--T:7-->
The amount of details provided for backup or restore is defined by the log level.
Check [[Special:MyLanguage/FAQ|FAQ]] to find the answers to most common questions.</translate>
 
== How to set a log level ==
 
You can control the reporting (verbose) level of the backup and restore protocol by setting a desired log level on a per-task basis. The following log levels are provided:
 
{| class="wikitable" style="width: 90%"
|- style="text-align:center;"
| style="width: 10%" | '''Setting'''
| style="width: 90%" | '''Log level details'''
|- style="vertical-align:middle; text-align:center;"
| scope="row"|
'''0'''<br>
'''1'''<br>
'''2'''<br>
'''3'''<br>
'''4'''<br>
'''5'''
| style="vertical-align:middle; text-align:left;"|
*print only standard and error messages together with summary<br>
*display a line for every item when its processing starts: 'sbc-3008: Info: Processing item: [xxx]...'<br>
*display a line for every item when its processing finishes: 'sbc-3108: Info: Item processed successfully: [xxx]'<br>
*display backup module processing information (with DB_API modules)<br>
*display underlying module processing XBSA and detailed DB_API modules<br>
*display packing data (mtf, cpio, sidf) trace messages
|-
|}
|}
=== Setting log level for backup ===
You can set the desired log level for each backup task in its properties:
# In the '''Main Selection''' -> '''Tasks''' -> '''By clients''', select your client and double-click the backup task for which you want to define the log level. The task properties window is displayed.
# Click the '''Options''' tab and under the '''Additional call arguments''' in the '''Save options''' field, enter the desired verbose level in the form: ''-v <No.>''. For example, setting the level to ''-v 3'' will write information on the item's processing into the log file.
[[image:backup_task_log_level.png|left|link=]]
<br clear=all>
=== Setting log level for restore ===
By default, the log level for restore is set to 1 (''-v 1'') if 1000 or fewer items are selected. You can set the desired log level for each restore operation in its properties:
#From the SEP sesam GUI menu bar, select '''Activities''' -> '''Restore'''. The ''New restore task'' window appears.
#In the last ''Save and start'' step of the restore wizard, click the '''Expert options''' button. Under the ''Options'' from the '''Verbose level''' drop-down list, select the desired log level for your restore.
[[image:restore_log_level.png|left|link=]]
<br clear=all>
== Backup problems ==
<div class="mw-collapsible mw-collapsed">
==== Client backup error ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*A client backup did not function properly. How can I determine where the problem is?
&rArr; '''Solution''' <br>
*Run the following commands to determine the error:
{{Attention Box|Caution!| The following commands produce a high network load}}
;BACKUP SERVER UNIX, CLIENT WINDOWS
  sm_ctrlc -l system  {client name} sbc -b -s -  f:/test  >/dev/null
Data from the F:/ directory on Windows is written over the network to the directory {{path|/dev/null}} on Unix. To display it, append <tt>-v 1</tt> to the command above. Everything written to {{path|/dev/null}} will be displayed.
  sm_ctrlc -l system  {client name}  sbc  -b -s  -  -v 1      f:/test  >/dev/null
;BACKUP SERVER UNIX, CLIENT UNIX
  sm_ctrlc -l root  {client name}  sbc  -b -s -  /usr  >/dev/null
To display the read data:
  sm_ctrlc -l root  {client name}  sbc  -b -s -  -v  1  /usr  >/dev/null
;BACKUP SERVER WINDOWS, CLIENT UNIX
  sm_ctrlc -l root  {client name}  sbc  -b -s -            /usr    > NUL
With backup data logging:
  sm_ctrlc -l root  {client name}  sbc  -b -s -  -v  1  /usr    > NUL
If the test backup is to be run on the target backup client only, execute the following command:
'''In the Unix directory {{path|<sesam>/bin/sesam/}}:'''
  sbc -b -s  -  /usr  >/dev/null
'''In the Windows directory {{path|<SESAM_ROOT>\bin\sesam\}}:'''
  sbc  -b -s  -  f:/test    > NUL
Enter <tt>-v 1</tt> to show the backed up data on your monitor.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Path backup on Windows is not working ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*SEP sesam Server failed to execute a path backup of a Windows client (however, a path backup without VSS is working). The following error is displayed:
Problem while loading dynamic link library: [WIN32 API error: 1114 - A dynamic link library (DLL) <br>initialization routine failed. LoadLibrary() call failed for: [vss.dll]].
'''Possible causes'''
*Typically, when <tt>dll</tt> cannot be initialised, a running antivirus solution is preventing it.
*The client's VSS configuration is incorrect.
&rArr; '''Solution'''
*Disable the antivirus software during backup.
*Check the client's VSS configuration by running the following commands:
**<tt>vssadmin list writers</tt> - check the status of all writers on a daily basis.
**<tt>vssadmin list shadows</tt> - check existing VSS copies.
**<tt>vssadmin list shadowstorage</tt> - check how much space is reserved and available space for VSS.
**<tt>vssadmin resize shadowstorage</tt> - set the reserved space for VSS snapshots to unlimited.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Failed to write the data to media during backup ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*During backup, operating system error "23 (ERROR_CRC)" is displayed.
'''Possible causes'''
*The tape drive cannot write proper blocks onto the backup media.
&rArr; '''Solution'''
*Check the tape drive and backup media.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Incorrect login or password ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*During backup, the message ''"Login incorrect. Password incorrect"'' is displayed.
&rArr; '''Solution'''
*Check your name resolution (DNS or <tt>etc/hosts</tt> file). The SEP sesam Server and SEP sesam Client must be reachable with or without FQDN and should be able to resolve each other correctly, including the reverse lookup. If the resolution is correct, do the following:
# In the SEP sesam GUI, go to '''Main Selection -> Tasks -> By clients''', and select the client with the backup problem.
# Open the backup properties and click the '''Options''' tab.
# Type ''-v 4'' at '''Save options'''.
# Start the backup again, then go to '''Main Selection -> Job state -> Backups''' and double-click the backup task to open its properties.
# Go to '''Logging -> Day log''' and search for the line ''Login incorrect. Password incorrect'' then correct the name resolution.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== WIN32 API error: "1450" ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*What should I do when a client backup fails with a WIN32 API error: ''"1450 - Not enough system resources to execute the requested service"''?
* The backup of a client may end with the following error message in the backup log:
sbc-1148: Error:  W2KSS Error: [WIN32 API error: 1450 - Not enough system resources to execute <br>the requested service.
Cannot store registry key: [SOFTWARE]. RegSaveKey() call failed in BackupRegistry().].
'''Possible causes'''
*Insufficient size of the registry/paged memory area. This problem affects SEP sesam as well as other backup tools, such as NTBackup.
&rArr; '''Solution'''
*The following Microsoft article explains approaches for different versions of Microsoft Windows: http://support.microsoft.com/kb/304101/en-us.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== System_State backup (RegLoadKey) error ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*What does the warning ''"The system cannot find path. RegLoadKey()..."'' during System_State backup mean?
*You may see the following output in NOT-log<!-- What is NOT-log? -->:
C:\Program Files\SEPsesam\var\tmp\usr_wf_S-1-5-21-220523388-1123561945-839522115-1003].
2010-04-13 02:04:20: sbc-2074: Warning: W2KSS Warning: [WIN32 API error: 3 -
The system cannot find path. RegLoadKey() call failed for
file: [C:\Documents and Settings\nn\ntuser.dat] in BackupUserProfiles().].
'''Possible causes'''
*There are inconsistencies in the OS configuration. The reason is that a user profile has been deleted but the user account still exists. ''System_State'' backup is looking for files corresponding to the user in the file system but the files no longer exist.
&rArr; '''Solution'''
*Delete the user in question or restore the profile date in the file system.
* Check the following in your registry to see whether it still includes references to usernames which no longer exist:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProfileList
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Access denied during Microsoft Windows backup via VSS ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*Why does a Microsoft Windows backup via VSS stop with the message ''"[CVssBaseObject::CreateVssBackupComponents] - Access denied"''?
'''Possible causes'''
*SEP sesam is not allowed to create a snapshot with the current user.
&rArr; '''Solution'''
*Check the user running the SEP sesam daemon and make sure that the user has all permissions to access the volume(s).
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Stream data length exceeds buffer capacity ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*What does the warning ''"Stream data length bigger than buffer can accept. Input buffer length = [65536], Stream data size = (High part)[0] (Low part)[65564]"'' ?
'''Possible causes'''
*SEP sesam uses 64 kB to back up Windows ACL files and folders and one object exceeds this buffer. You can use the Windows command <tt>icacls</tt> to display the ACL of a file or folder. The output looks like this:
C:\>icacls "C:\Documents and Settings\LocalService\Local Settings\Temp"
C:\Documents and Settings\LocalService\Local Settings\Temp NT AUTHORITY\LOCAL SERVICE:(I)(F)
                                                            NT AUTHORITY\LOCAL SERVICE:(I)(OI)(CI)(IO)(F)
                                                            NT AUTHORITY\SYSTEM:(I)(F)
                                                            NT AUTHORITY\SYSTEM:(I)(OI)(CI)(IO)(F)
                                                            BUILTIN\Administrators:(I)(F)
                                                            BUILTIN\Administrators:(I)(OI)(CI)(IO)(F)
Successfully processed 1 files; Failed processing 0 files
If you get several hundred or thousand lines, there is something wrong with the ACL.
&rArr; '''Solution'''
*Reset the permissions of the file's respective folder by using the command:
C:\>icacls "C:\Documents and Settings\LocalService\Local Settings\Temp" /reset
This command inherits the permissions of the parent object. You may have to adjust the permissions after running this command if manual settings have been applied for this object.
</div>
</div>
<!-- This entire topic (10054) must be reviewed so that it can be properly written. For the most part, it makes no sense.
<div class="mw-collapsible mw-collapsed">
==== Network connections failure on physical or virtual systems ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*Network Connections fail on physical or virtual systems. The log files contain one of the following error messages:
10054 An existing connection was forcibly closed by the remote host
or
Error : Network communication problem: SOCKET error: 10054 - The virtual circuit which reset by the <br>remote side . recv () call failed.
'''Possible causes'''
*;Virtualization Solutions
Citrix XenTools and Installing VMware Tools may also create your own network card driver in the virtual machine, which will then be used instead of the regular Windows system drivers.
The Paravirtual network drivers can sometimes cause the following problems to occur :
* General CPU load of about 30% within a VM when idle
* Very poor transfer rates, even on 10 Gigabit networks or 1 Gigabit LAN
* Disconnections
According to Microsoft documentation, the above error message says that the connection was reset by the client, so the tcp RST comes from the client system.
On the SEP sesam Server, the problem can be visible  as follows :
* The backup remains in the status "active" with a 0 GB/h performance.
* There are active <tt>sm_sms_backup</tt> processes.
* There are active <tt>sm_stpd</tt> processes.
SEP sesam has no feedback from the client that the backup was aborted. The connection was "hard" reset.
*;Network/Port trunking
In several customer environments, port trunking has been identified to either side of the system to be backed up or to the backup server side. After the trunk has been dissolved, the actions were able to be performed without problems. Ordinarily, this type of disconnection happens in less than 5 minutes but can happen randomly. This is almost always related to a trunking problem but could be the result of TSO corruption on virtual machines or even physical machines with first revision 10/100 network cards.
Use this trunking configuration guide to resolve trunking issues http://kb.vmware.com/selfservice/microsites/search.do?cmd=displayKC&externalId=1004048
*;Firewall
Firewalls reach through stateful inspection measures active in the transport of data and can therefore be a cause of the problem. If the disconnection occurs in less than 5 minutes, it is likely a TSO/trunking issue. If the disconnect happens at almost exactly 5 or 60 or 120 minutes, it is a KeepAlive problem on NAT/PAT router or firewall issue.
*;Virus scanner
Virus scanners intervene actively in the data transmission and related processes and may thus be the cause of the problem. A false positive from an antivirus application will cause intermittent and random failures.
Exclude virus scanner recommendation for SEP sesam
It is recommended to use the antivirus exclusions for SEP sesam as they can have adverse effects on backup and restore operations, for example:
*GUI is very slow or hangs for several seconds
*Sudden discontinuation of backup or restore jobs
*Reduced throughput and speed
The following objects must be excluded from any virus scanner activities:
*All SEP sesam installation directories on the backup server, client and Remote Device Server:
*<tt>SESAM_BIN</tt> directory including all subdirectories
*<tt>SESAM_VAR</tt> directory including all subdirectories
* DataStore on the backup server and Remote Device Server
**each volume on which a DataStore is filed, must be excluded from virus scanning
*All SEP sesam processes on the backup server, client and Remote Device Server. Close all executable files from the following directories from:
***<SESAM_ROOT> / Bin / sesam / *. *
**<SESAM_ROOT> / Bin / sms / *. *
Alternatively, the "child process monitoring" option can be disabled with some virus scanners to the exclude rule settings.
Then only need the following September islets excluded sesam processes:
'''1. Windows''':
*sm_main.exe
*sm_ctrld_main.exe
*sm_db_main.exe
*sm_passd.exe
*sm_rmi_main.exe
*sm_sepuler.exe
*sm_sms_main.exe
*sm_data_server.exe
*sm_stpd_main.exe
*sbc.exe
'''2. Linux''':
*sm_qm_main
*SM_CTRLD_MAIN
*sm_db_main
*sm_passd
*sm_rmi_main
*sm_sepuler
*sm_sms_main
*sm_data_server
*sm_stpd_main
*sbc
*;Error on SEP sesam Server side
*
* If there is a <tt>sm_stpd.exe</tt> or <tt>sm_stpd</tt> problem when a backup in the event viewer is abandoned or during the <tt>dmesg</tt> output of a SEP sesam Server, the problem must be analysed on the SEP sesam Server side.???Originally:  If the time of abandonment of the backup in the event viewer or the <tt>dmesg</tt> output of a SEP sesam Server a problem with the process <tt>sm_stpd.exe</tt> or <tt>sm_stpd</tt> on, so the problem of sesam server side to be analyzed.???
* Incorrect routing can also be the cause of this problem. For example:
**The SEP sesam Server and SEP sesam Client are on two different networks. Routing is not controlled by one central router but via static routes on the other network. A ping from the SEP sesam Server to the client works, but not the other way around.
In the case described in the SEP sesam Server was the ''Permanent'' set route in the network of clients, but she was not part of the ''active'' routes. ???What this means???<br>
To solve this problem, delete and re-add the route:
route delete <NetzwerkdesClients>
route add -p <NetzwerkdesClients> mask <NetzmaskedesClientnetzwerkes> <IPdesSesamServers>
&rArr; '''Solution'''
*;Turn ''Task offloading'' off
''' VMs '''
Turn off the TSO (TCP segment offloading) feature in the VM. Both Citrix XenServer and VMware ESXi are available in the network, the existing types "TSO" (TCP segment offloading).
This feature allows you to swap out different operations that must be performed during the fragmentation of network packets to the network interface card (checksum calculation).
Sense, it is the CPU load thereby reduce because the actual calculation is then performed on the network card.
The XenServer NIC drivers are more affected by this problem.
''' Windows '''
The following Microsoft article describes how this feature can be disabled on Windows Server 2003 systems:
http://support.microsoft.com/?scid=kb % 3ben -us % 3B904946 & x = 12 & y = 10
In the end, is in the registry of the key set "is DisableTaskOffload '' '' " to prevent the " offloading " on the network card :
http://technet.microsoft.com/en-us/library/cc959732.aspx
Under this option set on the backup client and rebooting additional backups are running smoothly.
''' Linux '''
On Linux, you can enable or disable the TSO settings via the Tools <tt> ethtool </tt> at run time:
ethtool -K eth0 tso off
*TCP Retransmission
The remedy of "TCP Retransmission" errors on the network level removes the root cause of the problem. <br>
To find " TCP Retransmission " error , the network analysis tool [ http://www.wireshark.org/ Wireshark ] is needed.
Start with Wireshark network analysis on the affected system : " Capture - > Interfaces "
'''Note :''' Retransmission error appear as black lines in the Wireshark log.
</div>
</div>
-->
==Disaster recovery on Linux==
<div class="mw-collapsible mw-collapsed">
==== The recovered system does not boot ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*The system does not boot because <tt>/root/dev/console</tt> cannot be found.
'''Possible causes'''
*Certain distributions rely on the existence of the directory <tt>/dev/</tt> while booting
* Certain static devices must exist before the <tt>udev</tt> daemon creates them.
&rArr; '''Solution'''
*Include the <tt>/dev/</tt> file system in your backup.
* If the restore cannot restore <tt>/dev/</tt>:
#Boot from the SEP sesam LIVE CD
#Mount the ROOT partition of the restored system
#Manually create the <tt>/dev/</tt> directory
#Manually create the <tt>/dev/console</tt> entry with:
mknod /path/to/target/mount//dev/console c 0 0
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== No bootable operating system can be found ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*The system is not able to find a bootable OS instance after the restore.
'''Possible causes'''
*There may have been problems during the installation of the GRUB boot loader.
&rArr; '''Solution'''
*The restore protocol includes a statement whether or not the installation of the boot loader was successful:
2009-12-14 14:48:27: sbc-3500: Info:    Reinstall boot manager
[/sesam/bin/sesam//sbc_grub_auto /mnt/disk/ AUTO]
*It is also possible to boot the system again from the live-CD, mount the target partitions and use <tt>grub-install</tt> to install the boot loader correctly.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== The device does not have a corresponding BIOS drive ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*During the restore, the following error occurs:
/dev/sda1 does not have any corresponding BIOS drive
'''Possible causes'''
*Check the file <tt>/boot/grub/device.map</tt> on the target system. If there are entries referring to the disk through <tt>/dev/by-disk/...</tt> as shown in the example below, the entry is most likely the reference to the hard disk partition of the broken system. GRUB will not find the proper device:
hd(0) /dev/disk/by-id/ata-SAMSUNG_SP2504C_S09QJ1GLA14263-part1
&rArr; '''Solution'''
*Reboot from the live-CD
*Mount the root and boot partitions to <tt>/mnt/disk</tt> (and <tt>/mnt/disk/boot</tt>, if necessary)
*Restart <tt>grub-install</tt> with the following options:
grub-install --root-directory=/mnt/disk --recheck hd0
Output:
grub-probe: error: Cannot open `/boot/grub/device.map'
/usr/sbin/grub-install: line 374: [: =: unary operator expected
Installation finished. No error reported.
This is the contents of the device map /mnt/disk/boot/grub/device.map.
Check if this is correct or not. If any of the lines is incorrect,
fix it and re-run the script `grub-install'.
(hd0)  /dev/hda
(hd1)  /dev/hdb
You can ignore the error <tt>line 374: [: =: unary operator expected</tt>. <br>More important is the result <tt>Installation finished. No error reported.</tt>
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== No corresponding BIOS drive for /dev/cciss/c0d0p2 ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*You receive the message: ''/dev/cciss/c0d0p2 does not have any corresponding BIOS drive'' in restore log.
&rArr; '''Solution'''
*Please see: [http://www.novell.com/support/php/search.do?cmd=displayKC&docType=kc&externalId=7001376&sliceId=1&docTypeID=DT_TID_1_1&dialogID=70466304&stateId=0%200%20134988932 Novell_support]
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== fsck.ext3: File system has unsupported features====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
* During a restore of a system with kernel version 2.4 the system may not boot because the Live-CD creates a file system with features which are not supported by kernel 2.4.
'''Possible causes'''
*Most likely the file system options <tt>resize_inode,dir_index,large_file,ext_attr</tt> are causing the problem and making the system unbootable.
&rArr; '''Solution'''
*Reboot from the Live-CD image, which includes the tool <tt>debugfs</tt>.
* Show the file system features with <tt>debugfs</tt>:
root@recover#: debugfs -w <b>/dev/sda2</b>
debugfs 1.41.1 (01-Sep-2008)
debugfs:  features
Filesystem features: has_journal ext_attr resize_inode dir_index filetype needs_recovery sparse_super large_file
quit
Replace <tt>/dev/sda2</tt> with the corresponding partition names on your system.
*To remove file system features:
root@recover#: debugfs -w <b>/dev/sda2</b>
debugfs:  features -resize_inode -ext_attr -dir_index -large_file -needs_recovery -sparse_super
Filesystem features: has_journal filetype
quit
After removing the options, the system should boot correctly.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Incorrect inode size (256) ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem '''
*After a successful restore the boot process stops with ''incorrect inode size (256)''.
'''Possible causes'''
*Older kernel versions (2.4) may use a different inode size than the one the file system's created through the Live-CD (which includes kernel 2.6). For example, this happens during the restore of SLES8 based systems which use an inode size of 128k.
&rArr; '''Solution'''
*This can only be solved by formatting the devices manually from the Live-CD, using the proper <tt>mkfs</tt> options:
mkfs.ext3 -I 128 /dev/sda1
After this step, remount the partition to <tt>/mnt/disk</tt> and repeat the restore operations. Changing the inode size is only possible by reformatting the devices.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Missing root file system ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*The restored system can't find a root file system and fails during resume.
'''Possible causes'''
*The <tt>/etc/fstab</tt> file was configured with the root file system as UUID.
&rArr; '''Solution'''
* Specify the root file system device name in conventional device names if you are using a different physical disk. After booting, use YAST to reconfigure your boot loader or edit your <tt>/boot/grub/menu.lst</tt> manually:
root=/dev/sda2
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Missing network cards ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*The restored system does not find any network cards.
'''Possible causes'''
*If the restore was done to dissimilar hardware, SLES based distributions may not configure the network devices correctly. SLESbased systems save their network configuration by using the system's MAC address. Most likely the system will not use <tt>eht0</tt> as a device name, but <tt>eth1</tt>, as it has another MAC address.
&rArr; '''Solution'''
*Use '''Yast''' and reconfigure your network interfaces.
</div>
</div>
== Graphical User Interface (GUI) problems ==
<div class="mw-collapsible mw-collapsed">
==== GUI Server not accessible ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*SEP sesam cannot access the GUI Server.
'''Possible causes'''
* The network connection to SEP sesam is broken.
* The GUI Server process is not running.
&rArr; '''Solution'''
*Make sure that the computer is running.
*Start the GUI server process by running the command <tt>sm main reload rmi</tt>.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Database connection failure ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*SEP sesam cannot connect to the database.
'''Possible causes'''
* The DB or RMI servers are not running.
&rArr; '''Solution'''
*Run the commands <tt>sm main reload db</tt> or <tt>sm main reload rmi</tt> to restart the servers.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== GUI does not start ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*The Graphical User Interface (GUI) fails to start.
'''Possible causes'''
* There is a problem with Java rights.
* The entry for the computer in <tt>sm java.policy</tt> is missing. For example:
// NET
permission java.net.SocketPermission "'mypcname:*"',
"'connect,accept,resolve"';
&rArr; '''Solution'''
* <!-- ?? -->
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Cannot read or write to the working directory ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*There is a problem with reading or writing to the working directory.
'''Possible causes'''
*The entry for the working directory in <tt>sm java.policy</tt> is missing.
;Windows example
// FILE
permission java.io.FilePermission
"'D:nsesamnvarn-"', "'read,write"';
;Linux/Unix/Tru64 example:
// FILE
permission java.io.FilePermission
"'/sesam/var/-"', "'read,write"';
&rArr; '''Solution'''
* <!-- ?? -->
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Online guide not available====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*The online guide cannot be accessed.
'''Possible causes'''
* Adobe Acrobat Reader is not installed.
* Adobe Acrobat Reader is installed but not configured in the GUI.
* The PDF file is not configured in the GUI.
&rArr; '''Solution'''
*Download Adobe Acrobat Reader from http://www.adobe.com.
<!--
* In the GUI, go to '''Configuration -> Defaults-> Online help - field: external reader''' and configure the external reader.
* In the GUI, go to '''Configuration -> Defaults -> Online Help - field: Address of PDF file''' and configure the PDF file. -->
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Online help not available ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*The online help cannot be accessed.
'''Possible causes'''
* There is no browser installed on the system.
* The browser is installed but not configured in the GUI.
* The HTML help file is not configured in the GUI.<!-- What HTML help file? -->
&rArr; '''Solution'''
*Install a browser.
<!-- * In the GUI, go to '''Configuration->Defaults->Online Help - Field: external browser''' and configure the browser.
* In the GUI, go to '''Configuration->Defaults->Online Help - Field: Address of HTML help file''' and configure the HTML help file. -->
</div>
</div>
{{Box Hint|Tips|
*Access rights for missing computers can be entered on the server side java policy file by running <tt>sm_setup allow_gui {host} {user}</tt>.
*It is not necessary to restart the GUI Server after making changes to the <tt>sm_java.policy</tt>. The refresh is explicitely allowed in <tt>sm_java.policy</tt> with entry <tt>permission java.security.SecurityPermission "getPolicy";</tt>.
*The syntax for pathnames in the <tt>sm java.policy</tt> is platform dependent.
*To test for problems with Java security, the line <tt>permission java.security.AllPermission;</tt> can be un-commented by remove leading '//'. This command removes the restriction to explicitly specified rights and switches it off <!-- switches what off? Java security?-->. To avoid security holes, this line should be commented out after the test (i.e. add the prefix '//‘)!}}.
== Network problems ==
<div class="mw-collapsible mw-collapsed">
====Network check====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*Network connection is not working.
&rArr; '''Solution'''
*Perform the network check. Use the commands ''ping'', ''nslookup'', address resolution etc. Check the connection with the corresponding SEP sesam access program (CTRL/SSH). The address resolution must be consistent, i.e., if for a TCP/IP name the resolution gives an IP-address, then the resolution for that IP-address must give the same TCP/IP name!
'''Example'''
  # nslookup decunix
  Server: seplinux2.sep.de
  Address: 193.28.59.40
  Name: decunix.sep.de
  Address: 193.28.59.94
  # nslookup 193.28.59.94
  Server: seplinux2.sep.de
  Address: 193.28.59.40
  Name: decunix.sep.de
  Address: 193.28.59.94
</div>
</div>
==Microsoft SQL Server==
<div class="mw-collapsible mw-collapsed">
==== Incorrect login ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*If a restore ends with errors and you find the following information in the log files, an attempt has been made to address a SQL Server instance on a client that is not entered locally on this system. The selected "Trusteed Connection" only allows the registration on a SQL Server where the instance is locally active:
DB Module: [DB-Library: Login failed for user '(null)'. Reason: Not associated with a trusted SQL Server connection.]
DB Module: [DB-Library message: Login incorrect.]
&rArr; '''Solution'''
*The backup client or end node on the active SQL Server must be changed.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Microsoft SQL Server backup failure ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
* Backup fails with the message ''"The server principal "NT AUTHORITY\SYSTEM" is not able to access the database "<database>" under the current security context."''
'''Possible causes'''
*The user "SYSTEM" is not allowed to connect to the MS-SQL database because the SEP sesam daemon runs as the user "SYSTEM" by default.
&rArr; '''Solution'''
*Change the SEP sesam daemon to a user account that has permission to connect to the database(s). Open the Windows service management console on your MS-SQL server, edit the properties of the SEP sesam service, switch to '''Log on''' tab and use valid credentials, then restart the SEP sesam daemon.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Restore fails with ''Directory lookup for the file '...' failed...'' ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*You receive the following warning:
DB Module: [DB-Library: Directory lookup for the file "e:\Database\SQL Server 2000 SE<br>\MSSQL\Data\sesam.mdf"failed with the operating system error 21(The device is not ready.).]
DB Module: [DB-Library: File 'sesam_db' cannot be restored to 'e:\Database\SQL Server 2000 SE<br>\MSSQL\Data\sesam.mdf'.
  Use WITH MOVE to identify a valid location for the file.]
'''Possible causes'''
* The existing path where the database files were located is not on the target system or an entry was made in the "Move" option that used a non-existing path name.
&rArr; '''Solution'''
*A pathname must be created or the correct path must be entered in the '''Move''' option. Entering the correct path name is the easier solution. Using a long path name in the '''Move''' option may cause problems, in which case the input can be shortened.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Restore failure due to SQL Server connection ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
* Restore fails with the message ''"Unable to connect: SQL Server does not exist or network access denied."'' You receive the following warning:
DB Module: [DB-Library message: Unable to connect: SQL Server is unavailable or does not exist. 
  Unable to connect: SQL Server does not exist or network access denied.; Net-Library message: ConnectionOpen (Connect()).; ]
'''Possible causes'''
*The selected server does not exist. It is possible that an instance was incorrectly entered without the server name.
&rArr; '''Solution'''
*Check the server name. If necessary, enter the restore target fully qualified as follows:
<tt><HOSTNAME>/<Instance>/<DB Name></tt>
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== "MOVE" option restore failure ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem 1'''
*Restore using the '''Move''' option fails with the warning ''The physical file name '...' may be incorrect.'' The following error occurs:
DB Module: [DB-Library: A file activation error occurred. The physical file name <br>'c:/temp/sesam_log.ldf' may be incorrect.
  Diagnose and correct additional errors, and retry the operation.]
DB Module: [DB-Library: File 'sesam_db_log' cannot be restored to 'c:/temp/sesam_log.ldf'.
  Use WITH MOVE to identify a valid location for the file.]
'''Possible causes'''
*The wrong syntax was used in the file name, e.g., / instead of \.
&rArr; '''Solution'''
*Enter the path with the correct syntax.
{{Box Hint|Note:| If the SEP sesam Server is using a '''Postgres''' database, e.g., with Linux x64, then the character '\' must be entered twice '\\', otherwise it will disappear. For example:
-a move=Mgmt_data:"e:\\SQL Server 2000 SE\\MSSQL\\Data\\Mgmt.mdf" -a move=Mgmt_log:"e:\\SQL Server 2000 SE\\MSSQL\\Data\\Mgmt_log.ldf"
}}
'''Problem 2'''
*Restore with "'''Move''' option fails with ''Logical file '...' is not part of database.'' The following error occurs:
DB Module: [DB-Library: Logical file 'Mgmt_data' is not part of database 'sesam_db2'.
  Use RESTORE FILELISTONLY to list the logical file names.]
'''Possible causes'''
*The wrong ''logical name'' was entered in the '''Move''' option.
&rArr; '''Solution'''
*Enter the ''logical filename'' correctly. This can be found in the backup log file (NOT-file). For example, in the backup log file, you see the following lines:
DB Module: [DB-Library: Processed 256 pages for database 'sesam_db', file 'sesam_db' on file 1.]
DB Module: [DB-Library: Processed 1 pages for database 'sesam_db', file 'sesam_db_log' on file 1.]
The logical file names in this case are <tt>sesam_db</tt> and <tt>sesam_db_log</tt> These should be entered in the '''Move''' option.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Restored database remains in the state ''Restoring'' ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*A database remains in state ''Restoring...'' after the restore finishes.
'''Possible causes'''
*This happens if the option '''Auto recover''' was not selected in the restore wizard.
&rArr; '''Solution'''
*Select option the option '''Auto recover''' in the restore wizard, or
*Execute <tt>sbc</tt> in the CLI with the option <tt>-a recover</tt> for the particular database. For example:
[[Image:MSSQL restoring.jpeg]]
*Call the <tt>sbc</tt> in the command line with:
sbc -r -a recover sbcmsql:"/MIRACULIX/SECOND/msdb"
{{Box Hint|Note:| During the restore of a database with additional transaction log files (generation restore), the database remains in the state ''"Restoring..."'' until the last restore (with the option <tt>-a recover</tt>) ends. }}
</div>
</div>
==Microsoft Exchange Server==
<div class="mw-collapsible mw-collapsed">
==== Exchange backup fails with VSS API error due to missing Microsoft Exchange VSS writer====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
When backing up Exchange, the backup fails because the Microsoft Exchange VSS writer required for backup is missing. The following error occurs:
sbc-1178: Error:  VSS API error: CVssServer::CreateSnapshot: No volume could be determined.
sbc-1146: Error:  DB Module: [BackupProcessing: For the specified backup source no volumes could be determined. Sources - \Microsoft Exchange Writer]
sbc-3052: Info:    Items processed correctly: [0]. Not processed or incorrectly processed items: [0]. (SF20160503083743700@BLljg0gnWAa)
sbc-1156: Error:  Operation failed!
sbc-3001: Info:    Exiting.
This error occurs when one or more writers required for backup are missing or not available. Note that this is not the same as VSS error or failed VSS. In the latter case, check [[Troubleshooting_Guide#Common VSS problems|Common VSS problems]].
A writer is consider missing, if running (as administrator) the Microsoft command-line tool <code>vssadmin list writers</code> shows no available Microsoft Exchange VSS writer. If a VSS writer is missing, all backups that use that writer to perform VSS snapshots will fail. A missing writer is a failure of the Windows operating system. To fix this issue, Windows registry needs to be edited. SEP sesam cannot back up any data until the required VSS writers are available.
'''Solution'''
{{note|SEP sesam is not responsible for any issue caused by Windows registry editing. Note that only experts should edit the registry, as using Windows registry editor incorrectly can cause serious problems, such as Windows to stop working. For more information on editing Windows registry, see [https://support.microsoft.com/en-us/kb/256986 Windows registry information for advanced users].<br />It is advised to back up the registry before making any change to it. It is also recommended to perform the following procedure outside of working hours as it requires restarting the Microsoft Exchange Information Store service.
}}
To enable Microsoft Exchange VSS writer, on the Exchange server open and edit the registry with the following key value:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MSExchangeIS\ParametersSystem\
"Disable Exchange Writer" DWORD=0
If the key already exists with a value of 1, change the value to 0. (Value 1 disables the Microsoft Exchange Writer.) For more information on enabling VSS Exchange writer, refer to [https://support.microsoft.com/en-us/kb/838183 How to turn on the Exchange writer for the Volume Shadow Copy service] (it is marked as relevant for Windows Small Business Server 2003, but the procedure can also be applied to later versions).
Then restart the Microsoft Exchange Information Store service:
#'''Log in''' to the Exchange server and click '''Start'''.
#Enter ''services.msc'' in the '''search box''', and press '''Enter'''. The ''Services'' window opens.
#From the list of services, right-click the '''Microsoft Exchange Information Store service (MSExchangeIS)''', and then click '''Restart'''. Note that during restart the users will be disconnected from Exchange.
After restarting Exchange, in the command prompt enter <code>vssadmin list writers</code> and verify that the VSS writers are listed. Then run your Exchange backup again.
</div>
</div>
==NetWare==
<div class="mw-collapsible mw-collapsed">
==== Checking the reachability of the TSA services ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*Determining all available TSAs of a NetWare/OES Server.
&rArr; '''Solution'''
*On a NetWare Server (the <tt>sbc_smdr</tt> command must be executed on a machine with the ''sesam-novell-client'' package installed):
  #> /opt/sesam/bin/sesam/sbc_smdr -D -N "nw1:::admin.admins.mydomain:novell:0" "/NetWare"
  2007-03-21 16:42:50: sbc-3500: Info:    ::/NetWare
  2007-03-21 16:42:50: sbc-3036: Info:    # @(#)SESAM BACKUP CLIENT FOR NETWARE FILE SYSTEMS, VERSION: 1.8R3 Build: 1.161 20070320 17:31:00 Linux i386 abas #
  2007-03-21 16:42:50: sbc-3074: Info:    Backup start time [20070321164250]
  2007-03-21 16:42:50: sbc-3500: Info:    Starting Session "SESAM SBC_NLM Session" ...
  2007-03-21 16:42:52: sbc-3500: Info:    NW1.NetWare File System
  "NW1.NetWare File System" d_ 2000.01.01 00:00:00 2000.01.01 00:00:00 4096 - ,
  2007-03-21 16:42:52: sbc-3500: Info:    NW1.Novell Directory
  "NW1.Novell Directory" d_ 2000.01.01 00:00:00 2000.01.01 00:00:00 4096 - ,
In this case, the TSAFS (NW1.NetWare File System) and TSANDS (NW1.Novell Directory) are loaded.
*On an OES(2)-Linux server:
  #> /opt/sesam/bin/sesam/sbc_smdr -D -N "oesnix1::oesnix1:backup:novell:0" "/NetWare"
  2007-03-21 15:55:01: sbc-3500: Info:    ::/NetWare
  2007-03-21 15:55:01: sbc-3036: Info:    # @(#)SESAM BACKUP CLIENT FOR NETWARE FILE SYSTEMS, VERSION: 1.8R3 Build: 1.161 20070320 17:31:00 Linux i386 abas #
  2007-03-21 15:55:01: sbc-3074: Info:    Backup start time [20070321155501]
  2007-03-21 15:55:01: sbc-3500: Info:    Starting Session "SESAM SBC_NLM Session" ...
  2007-03-21 15:55:01: sbc-3500: Info:    OESNIX1.GroupWise System
  "OESNIX1.GroupWise System" d_ 2000.01.01 00:00:00 2000.01.01 00:00:00 4096 - ,
  2007-03-21 15:55:01: sbc-3500: Info:    OESNIX1.Linux File System
  "OESNIX1.Linux File System" d_ 2000.01.01 00:00:00 2000.01.01 00:00:00 4096 - ,
The TSAFSGW (OESNIX1.GroupWise System) and TSAFS (OESNIX1.Linux File System) are loaded.
'''Problem'''
*Determining the sources (resources) of a Target Service File System.
&rArr; '''Solution'''
*Depending on your installed services, these TSA's are visible:
**NetWare File System
**Linux File System
**GroupWise System
**Novell Directory
**iFolder Store
**Linux Cluster File System
**NetWare Cluster File System
{{Box Hint|Note:| To enable debug mode for TSA, see http://www.novell.com/coolsolutions/tip/17179.html }}
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Unable to browse or backup a NetWare Server ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*It is not possible to browse or back up a NetWare Server.
'''Possible causes'''
*No TSA is loaded, or
* The wrong data mover was inserted.
&rArr; '''Solution'''
*Restart the '''NetWare file system''' with <tt>unload TSAFS</tt> and <tt>load TSAFS</tt>.
*Edit the properties of the NetWare Server in SEP sesam and adjust the data mover in the '''NetWare Access''' tab.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
====  Sesam Error: Client returns no data ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*Th following error message appears in <tt>/var/log/messages</tt> on OES Linux client:
  nds_nss_GetGroupsbyMember: failed to init socket, status = 0
  nds_nss_GetPwdbyName: init sock returned 0
  nds_nss_GetPwdbyName: init sock returned 0
  nds_nss_GetPwdbyName: init sock returned 0
&rArr; '''Solution'''
*Fix the ''lum setup'' so that eDirectory authentication can complete.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Error messages during a backup ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Message'''
*(0XFFFDFFD7) "Login denied".
'''Possible causes'''
*Invalid username or password.
&rArr; '''Solution'''
*Edit the properties of the client in SEP sesam and adjust the login data in the '''NetWare Access''' and ''' Novell SMS''' tabs.
<br>
'''Message'''
*(0XFFFDFFCD) "A data stream cannot be opened." "Unable to open a data stream."
'''Possible causes'''
*The user does not have permission to access all data.
&rArr; '''Solution'''
*Change the user name or adjust the permissions.
<br>
'''Message'''
*0XFFFEFFCC) "Could not write an object to NDS or write to a stream", or
*  (0XFFFEFFB1) "Connection to remote host is lost. Remote host might have disconnected."
'''Possible causes'''
*The TSA or the <tt>smdr</tt> deamon is not running.
&rArr; '''Solution'''
*Check TSA with <tt>opt/novell/sms/bin/smsconfig -t</tt>.
<br>
'''Message'''
*(0XFFFDFFDC) "An invalid path was used."
'''Possible causes'''
*A wrong backup path was used or the TSAFS was loaded in an incorrect mode.
&rArr; '''Solution'''
*In the event of <tt>--tsamode=dual</tt>, it is possible to simply use a Linux path.
*The source ''NetWare server'' backs up all existing volumes respectively.
* "<tt>VOL-NAME:</tt>" backs up a specific volume when using <tt>--tsamode=netware</tt>.
* The option <tt>--tsamode=linux</tt> supports ''path to the volumes/volumename'' only.
* In the event of a restore, insufficient access rights could be a reason for this message.
<!-- This bit is quite unclear -->
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Files are locked after backup, server freezes ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
* Files are locked for several minutes after a backup and the server freezes spontaneously, requiring a reset.
&rArr; '''Solution'''
*Update the sesam-novell-client to version 3.4.1.78 or higher to solve this problem.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== File-based backup is faster than Novell volume backup ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*The file-based backup is faster than the Novell volume backup.
&rArr; '''Solution'''
*Disabling the TSA-cache will increase the performance of a Novell-based backup and also decrease the system load.
* Edit the file <tt>/etc/opt/novell/sms/tsafs.conf</tt>, change the line ''"cachingmode=enable"'' to ''"cachingmode=disable"'' and apply the settings with <tt>rcnovell-smdrd restart</tt>.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Checking the performance and availability of a NSS volume via tsatest on OES2 ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
*Back up the resource ’/ ’using the supplied credentials.
<tt>tsatest -u root -p unsecure</tt>
<br>
*Back up the resource ‘/home' using the supplied credentials.
<tt>tsatest --path=/home -u root -p unsecure</tt>
<br>
*Back up the NetWare target SYS:\SYSTEM on ACME_SERVER using the supplied credentials.
<tt>tsatest -s ACME_SERVER -v SYS: --path=SYSTEM -u root -p unsecure</tt>
<br>
*Back up the / resource using the supplied credentials and a buffer size of 131072 bytes.
<tt>tsatest -b 131072 -u root -p unsecure</tt>
<br>
*Back up the resource ’/ ’ on server ACME_SERVER using the supplied credentials. This will perform a remote backup if ACME_SERVER is not the server on which tsatest is loaded/executed.
<tt>tsatest -s ACME_SERVER -u root -p unsecure</tt>
<br>
*Back up the resource /proc/usb using the supplied credentials. Excludes all datastreams and extended attributes. The value 6144 is arrived by a bitwise ORing of the values for NWSM_EXCLUDE_EXTENDED_ATTRIBUTS (0x0800) and NWSM_EXCLUDE_DATA_STREAMS (0x1000).
<tt>tsatest --path=/proc/usb -u root -p unsecure -c 6144</tt>
<br>
*Back up the NetWare virtual server node represented by CLUSTER_OBJECT_CLUSTERPOOL_SERVER.
<tt>tsatest --cluster -s CLUSTER_OBJECT_CLUSTERPOOL_SERVER</tt>
<br>
*Back up the specified volume, ’RESOURCE_ON_THE_CLUSTER_POOL’ on the NetWare virtual server node represented by CLUSTER_OBJECT_CLUSTERPOOL_SERVER.
<tt>tsatest --cluster -s CLUSTER_OBJECT_CLUSTERPOOL_SERVER -v RESOURCE_ON_THE_CLUSTER_POOL</tt>
<br>
To check the performance on a NetWare Server, use these instructions:
http://support.novell.com/docs/Tids/Solutions/10092890.html
</div>
</div>
==Oracle==
<div class="mw-collapsible mw-collapsed">
==== Testing the Oracle extension with ''sbttest'' on AIX does not work ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
* Testing the Oracle extension with <tt>sbttest</tt> on AIX will not work unless the full path to the library with argument <tt>-libname</tt> is specified.
&rArr; '''Solution'''
*When running <tt>sbttest</tt> on AIX, specify the full path to the library with argument <tt>-libname</tt>, e.g., <br /><code>sbttest test1 -libname /opt/sesam/bin/sesam/libobk.so</code> or ... <code>-libname $ORACLE_HOME/lib/libobk.so</code>.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Errors when attempting to perform a backup on AIX ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
* Running <tt>RMAN</tt> command on AIX ends with errors.
&rArr; '''Solution'''
*<tt>RMAN</tt> command on AIX requires that the full path to the library is set in the script via <tt>PARMS SBT_LIBRARY={full_path_to_libobk.so}</tt>. For details, see [[SEP_sesam_Extension_for_Oracle#rman_specific|RMAN specific parameters]].
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Rerunning the ''sbttest'' script ends with ''duplicate key'' error====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
* When rerunning the <tt>sbttest</tt> script with the same <tt>backup_file_name</tt> parameter, SEP sesam returns ''duplicate key'' error.
'''Cause'''
*This happens because the <tt>sbttest</tt> is using the same <tt>backup_file_name</tt> argument on the next run. SEP sesam interprets <tt>backup_file_name</tt> as the ''save_set_id'' and compares it with the IDs in the results table. When the same ''save_set_id'' is found, SEP sesam returns ''duplicate key'' error.
&rArr; '''Solution'''
*When running <tt>sbttest</tt>, make sure that the <tt>backup_file_name</tt> argument is set to a different value for each run of the script.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Running ''bash'' script on AIX results in ''bad interpreter: No such file or directory'' error====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
<ul><li>When running a <tt>bash</tt> script, a ''bad interpreter: No such file or directory'' error message is shown, for example:</li>
-sh: ./sbc_oracle_rman.sh:
/bin/bash: bad interpreter: No such file or directory
</ul>
'''Cause'''
*Typically, on AIX <tt>bash</tt> is not included in the list of valid shells.
&rArr; '''Solution'''
*Change the first line in <tt>sbc_oracle_rman.sh</tt> to <br /><code>#!/bin/sh</code>.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== ''ORACLE_HOME'' and ''ORACLE_SID'' variables are not set in the user environment====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*If <tt>ORACLE_HOME</tt> and <tt>ORACLE_SID</tt> are not defined, SEP sesam script cannot connect to the target database.
&rArr; '''Solution'''
<br />Set <tt>ORACLE_HOME</tt> and <tt>ORACLE_SID</tt> variables using any of the following:
<ul><li>Add the lines <br /><code>export ORACLE_HOME=/u01/app/oracle/product/10gR2/db_1</code> and <code>export ORACLE_SID=PROD_DB</code>.</li>
<li>Use <tt>oraenv</tt> to set the appropriate environment, for example:</li>
export ORACLE_SID=TEST
export ORAENV_ASK=NO
. oraenv
</ul>
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== SAP Oracle: "''item from input file does not exist''" ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
<ul><li><tt>brbackup backint</tt> log on Windows reports "''item from input file does not exist''". The following error messages appear:</li>
In <tt>backint_<SID>.log</tt>
  SSB:(3620): 121043: backint_back.c:( 331):: WARNING: item from input file does not exist: F:\ORACLE\T11\SAPDATA1\ERPUSR_1\ERPUSR.DATA1.
In <tt>sbc_<SID>.log</tt>
  SSB:(3620): 121242: backint_func.c:(1928):: 2013-06-18 12:12:42: sbc-3008: Info:    Processing item: [F:\ORACLE\T11\SAPDATA1\ERPUSR_1\ERPUSR.DATA1]...
  SSB:(3620): 121242: backint_func.c:(1928):: 2013-06-18 12:12:42: sbc-4000: Trace:  GetFileSecurityInfo: Opening file [\\?\F:\ORACLE\T11\SAPDATA1\ERPUSR_1\ERPUSR.DATA1] with CreateFileW() function failed. Error code: 1314
  SSB:(3620): 121242: backint_func.c:(1928):: 2013-06-18 12:12:42: sbc-2046: Warning: Cannot get item security data for [F:\ORACLE\T11\SAPDATA1\ERPUSR_1\ERPUSR.DATA1].
</ul>
'''Possible causes'''
*The user starting the <tt>brbackup</tt> process does not have permission to access the security data (ACL) of the file <tt>F:\ORACLE\T11\SAPDATA1\ERPUSR_1\ERPUSR.DATA1</tt> in Windows. Typically, only local group administrators have permission to read or write an object's SACL, which is controlled by the privilege or user right ('''SeSecurityPrivilege''').
&rArr; '''Solution'''
*Assign the user to the local administrator group of the SAP server.
*Ensure that the user right ('''SeSecurityPrivilege''') is implicitly or explicitly given to the user.
*It may also be necessary to set the '''User Account Control Settings''' to '''Never notify''' through the Control Panel.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== The RMAN file name is too long ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*You receive the warning:
ORA-19506: failed to create sequential file, name="full_COMP1_1953897796_55938_1.bck", parms=""
'''Possible causes'''
*The file name of the backup set created by the RMAN is longer than 32 characters. For example, if the Oracle backup file format is set to <tt>format 'full_%d_%I_%s_%p.bck'</tt>, when the parameter <tt>%s</tt> (backup set number) is integrated into the filename, the backup set number increases with every backup. As a consequence, the count of characters of that string will increase. Increasing the number to over 32 characters will cause the backup to fail.
&rArr; '''Solution'''
*Make sure that the character length of the backupset does not exceed 32 characters.
</div>
</div>
==Informix==
<div class="mw-collapsible mw-collapsed">
==== General troubleshooting ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
* Ensure that the following environment variables are correctly set:
**INFORMIXDIR
**INFORMIXSERVER
**ONCONFIG
**ROOTPATH
* Make sure to check the messages on the SEP sesam Server.
* Additional information can be found in the <tt>ONBAR</tt> and <tt>SIB</tt> log files.
* SEP recommends using a single log file for <tt>ONBAR</tt> and <tt>XBSA</tt> messages. You will then be able to see all calls from the database and SEP sesam in the correct order for this set environment variable:
XBSA_LOGFILE=<complete path to ''bar_act.log>'' and  XBSA_TRACE=1.
* All SIB (sesam) messages have the prefix ''SIB''.
* For more information, set <tt>XBSA_TRACE</tt> to 2, but then the log files can become quite large.
* To activate the <tt>ONBAR</tt> log, edit the following line in the <tt>onconfig</tt> file:
BAR_DEBUG      2    \# where 'num' = 0-9; 9 producing heaps output defaults to {{Path|/tmp/bar_dbug.log}}
<!-- Perhaps...?:
  BAR_DEBUG      2    \#
where 'num' = 0-9; 9 producing heaps output defaults to {{Path|/tmp/bar_dbug.log}} -->
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Specific error messages ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
*'''Error message when executing <tt>oninit</tt>'''
Allocating and attaching to shared memory...FAILED
oninit: Fatal error in shared memory creation
&rArr; '''Solution'''
*Please read this article: http://www-01.ibm.com/support/docview.wss?uid=swg21501819
*'''Error during first backup attempt'''
Begin backup of critical file 'C:\PROGRA~1\IBM\Informix\11.70\etc\ixbar.0'.
(-43078) Open or close failed on file 'C:\PROGRA~1\IBM\Informix\11.70\etc\ixbar.0', errno = 2 .
&rArr; '''Solution'''
*Create the missing file here: <tt>C:\PROGRA~1\IBM\Informix\11.70\etc\ixbar.0</tt>.
(See [https://www-304.ibm.com/support/docview.wss?uid=swg1IC50591 IC50591: IXBAR.FILE IS REQUESTED DURING AN EXTERNAL RESTORE ALTHOUGH NO BACKUP WAS CREATED])
*'''Error 131 during first logical logs backup attempt'''
  Unable to start the logical log backup: Log backup to device 'nul' not allowed
  ...
  C:\PROGRA~1\IBM\Informix\11.70\bin\onbar_d complete, returning 131 (0x83)
&rArr; '''Solution'''
*Set <tt>LTAPEDEV</tt> in <tt>ONCONFIG</tt> file to a value different to '/dev/null' or 'NUL', e.g. <tt>LTAPEDEV \\.\TAPE0</tt> for Windows. See [http://publib.boulder.ibm.com/infocenter/idshelp/v10/index.jsp?topic=/com.ibm.adref.doc/adref109.htm IBM Informix Dynamic Server LTAPEDEV]
</div>
</div>
==Lotus Domino Server==
<div class="mw-collapsible mw-collapsed">
==== Lotus Domino Server backup reports recovery failure ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*Backup reports ''"Recovery may fail"'' during backup of the SEP sesam extension for Lotus Domino Server. During the backup, the following warning appears for several or all Notes databases:
sbc-2076: Warning: Item [D:\notus03data\mailboxes\mail1\cruoff.nsf] is not logged. <br>Recovering may fail.
'''Possible causes'''
*There may be two reasons for this:
# '''Transactional logging''' was not turned on or is not in '''Archived''' mode.
# '''Transactional logging''' is running in '''Archived''' mode but is explicitly turned off for this database in the options of the database.
&rArr; '''Solution'''
*This message is a warning of the Notes Backup API and is only forwarded by SEP sesam. Turn on '''Transactional logging''' in general or just for this database.
Other than that, the message can be ignored. The warning is given during the backup for safety reasons because only the admin can determine if administrative intervention is necessary.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Insufficient temporary space ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*Temporary space may not suffice because every database must first be copied to the client.
&rArr; '''Solution'''
*Change the path <tt>gv_rw_tmp</tt> in <tt><SESAM_VAR>/ini/sm.ini</tt> to a directory with sufficient space.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Transactional logging not active ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*The INCR backups fail.
'''Solution'''
*Activate '''Transactional logging''' in ''Archived'' mode for Notes.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Transaction logs already in progress ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*This message appears in the SEP sesam:
DB Module: [Archiving of transaction logs already in progress.]
'''Possible causes'''
*The Lotus Notes API sends this message to show that the transactional logs are already in the state ''Backup''. The state cannot be set twice. If a backup could not be completed successfully, this state mat appear.
&rArr; '''Solution'''
*To finish the backup status, all <tt>logasio</tt> processes should be removed from the Notes system:
  UNIX:    killall -9 logasio
  WINDOWS:  sm_kill logasio
*Alternatively, you can reboot the Notes server.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Backup reports incorrect transactional logging ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*After the restore of '''Transactional logging''', Notes reports incorrect Transactional logging.
&rArr; '''Solution'''
*Delete the <tt>nlogctrl.*</tt> files in the log directory then restart the Notes server.
</div>
</div>
==== Server fails to restart after a Notes server crash ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*After a crash of the Lotus Notes server, the server cannot be started without rebooting.
&rArr; '''Solution'''
*If a server crash occurs during a log backup ,<tt>logasio</tt> processes may remain active. These processes must be stopped. The server can be restarted after running the following command:
  UNIX:    killall -9 logasio
  WINDOWS:  sm_kill logasio
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Backup with missing options ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*The restore of Notes on a Linux client ends with:
  "RESTORE STATUS: Restore failed. 2007-05-02 08:52:32:
  sbc-1146: Error:    DB Module: [Notes API NotesInitExtended() failure"
'''Possible causes'''
*The restore options are not identical to the backup options.
&rArr; '''Solution'''
*Set the restore options according to the task. Additionally, the options can be set in the restore wizard under '''Expert options''' in the '''Options''' tab. For example:
  -v 3 -a USER=nadmin -a NOTESINI=/srv/notedata/notes.ini
</div>
</div>
==== Abnormal termination of the sbc.exe process ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*Lotus Domino Console repeats: ''"C:\..\SEPSesam\bin\sesam\sbc.exe Process has terminated abnormally"''.
'''Possible causes'''
*If there is a backup failure that causes the SEP sesam backup client to terminate abnormally, the failure will be notices by the Lotus Domino server API and repeat this error message every minute in its logging. If this persists over multiple reboots, please read this article from IBM on how to remove the message from the Domino logging: http://www-01.ibm.com/support/docview.wss?uid=swg21252974
&rArr; '''Solution'''
*Stop the Domino server forcibly by running <tt>nsd -kill</tt>.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Restoring Notes database files to different location doesn't work ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
* When doing a restore of database files as a Notes restore to a different file location under Notes_Data, all databases are skipped.
'''Possible causes'''
*Notes denies an access to an existing database with the same replica-id, e.g.:
Item [\JOBSCHED.NJF] not included. Skipped...
&rArr; '''Solution'''
*In the SEP sesam restore wizard, select a file location outside of Notes_Data and store the database file there. This makes it possible to copy the file to the Notes data directory structure.
</div>
</div>
==VMware vStorage API==
===''Version 4.4.3.22 and previous''===
<div class="mw-collapsible mw-collapsed">
====Single item restore of migrated save sets does not work with version 4.4.3.22====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*Single item restore of migrated save sets does not work with version 4.4.3.22.
&rArr; '''Workaround'''
*This issue is solved with the patch. Contact support or Upgrade to a higher 4.4.3.x version.
</div>
</div>
===''Version 4.4.2.87 and previous''===
<div class="mw-collapsible mw-collapsed">
==== Restoring VMware vSphere 6 does not work with SEP sesam 4.4.1====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*Backup of vSphere 6 works with capabilities of VDDK 5.5. But restore does not work at all with 4.4.1 due to check of vSphere version of SEP sesam GUI.<!__Don't understand this last sentece?-->
&rArr; '''Workaround'''
*No workaround exists for version 4.4.1. Upgrade to SEP sesam version ≥ 4.4.2 to be able to restore vSphere 6.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
====VM configuration restore uses a lot of hard disk space====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*If only the configuration of a VM containing thick provisioned VMDKs is restored, the new VMDKs will have the same size as the original VMDKs. This is because SEP sesam creates empty VMDKs during the restore and uses the full disk size for thick provisioned disks. (For thin provisioned disks 0 bytes are reserved.)
&rArr; '''Workaround'''
*Make sure that there is enough space in the target data store for restoring thick provisioned VMDKs related data.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
====Backup of VMs using VDDK 5.1.1 on Linux occasionally fails====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*Backups of VMs using VDDK 5.1.1 on Linux might fail. These known issues in VDDK 5.1 have been fixed in the update. For more information, see VMware Knowledge Base article [http://kb.vmware.com/kb/2039931 Third-party backup software using VDDK 5.1 may encounter backup/restore failures].
&rArr; '''Workaround'''
*[https://my.vmware.com/web/vmware/details?downloadGroup=VSP510-VDDK-51U1&productId=285 Download the VDDK version 5.1.1 update] in which this issue is fixed.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
====Backup of VMs with two VMDK files with the same file name does not work====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*If a virtual machine (named ''vmware'') uses the VMDK files with the same name, e.g., ''[Datastore1]/vmware/vmware.vmdk'' and ''[Datastore1]/vmware_org/vmware.vmdk'' , the backup will fail.
&rArr; '''Workaround'''
*Rename one of the virtual disks to a name different than the first one.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== SSL handshake error during browse of vSphere server ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*The name ''"VMware vSphere:"'' appears again after expanding it.
* A pop up opens, which refers to this page
'''Possible causes'''
*This issue is related to VMware vSphere 5.5 <!--(may also 5.1)?--> and IBM Java due to changes in OpenSSL.
&rArr; '''Solution'''
*install Oracle Java instead of IBM Java, because Oracle Java is able to connect to vSphere 5.5. After installing Oracle Java, the java link in  <tt>/opt/sesam/bin/sesam</tt> needs to be adjusted to redirect it to Oracle Java.
*Change the list of allowed cyphers on the vSphere server. See http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=2049143 for further information.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== "Error:  VM Exception: [HostCommunication]." ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*A VADP backup ends with the error message ''"Error:  VM Exception: [HostCommunication]."''.
* In the event log of the hyper visor, the following error message occurs at the same time if
** a snapshot should be created or deleted on this host
** a virtual machine should be migrated to or from this host
** a virtual machine on this host should be cloned
An error occurred while communicating with the remote host.
'''Possible causes'''
*One of the management services on the hypervisor is not or not correctly running.
&rArr; '''Solution'''
*Log onto the ESXi server via ssh
* Restart the vpxa Service
/etc/init.d/vpxa restart
See also: [http://kb.vmware.com/kb/1003490 Restarting the Management agents on an ESXi or ESX host]
</div>
</div>
<div class="mw-collapsible mw-collapsed">
====  "Execution error of set_vddk.ps1 according vmware-vdiskmanager.exe"  ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*The required msvcr90.dll for this application is not available.
&rArr; '''Solution'''
*Install the "Microsoft Visual C++ 2008 Service Pack 1 Redistributable Package ATL Security Update", which includes the library: http://www.microsoft.com/en-us/download/details.aspx?id=11895
</div>
</div>
<div class="mw-collapsible mw-collapsed">
====  GUI reports ''Login denied'' during browsing the vSphere farm ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*When vCenter user and password have been verified and the error is still running, you can check the VMware farm access without a graphical user interface (GUI).
'''Possible causes'''
*Occasionally, there are problems with special characters in passwords. For a better analysis of these problems, it would help to check the VMware vSphere farm connection using the command line.
&rArr; '''Solution'''
*In the following command you have to replace the vCenter server name, username and password with your own environment's variables.
'''Pattern''':
  <pre><nowiki>sbc_vadp -D -a username=<vCenter username>,password=<password>,url=https://<vCenter Hostname>/sdk,ignorecert=ignorecert "/VMware vSphere:"</nowiki></pre>
For example:
  <pre><nowiki>sbc_vadp -D -a username=Administrator,password=mypassword,url=https://ws2008x64/sdk,ignorecert=ignorecert "/VMware vSphere:"</nowiki></pre>
It should then be listed in the configured VMware Data Center. If that is not the case, then set the password without special characters. If the access test to the farm is successful, then the original password contained a character that caused the problem accessing the VMware farm.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
====  Error: At least one snapshot exists before CBT was enabled, which is not possible ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*You receive the warning: ''"Error: At least one snapshot exists before CBT was enabled, which is not possible"''
'''Possible causes'''
*VM is suspended.
*Manual snapshots available.
&rArr; '''Solution'''
*Restart or shut down VM
*Delete manually created snapshots and then perform a reset CBT
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== VIX_E_FAIL ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*An error occurs during thr backup of the second VMDK.
'''Possible causes'''
*Timeout in vCenter connection.
&rArr; '''Solution'''
*Update the VDDK library to version 1.2.1.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== VIX_E_FILE ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*You receive one of the following warnings:
**VIX_E_FILE_NOT_FOUND:
**VIX_E_FILE_ACCESS_ERROR:
**You do not have access rights to this file:
**Thin/TBZ/Sparse disks cannot be opened in multi writer mode.
'''Possible causes'''
*Wrong VMDK file has been linked for backup.
&rArr; '''Solution'''
*Start backup with the option '''<tt>-a qui=0</tt>'''. The system will boot in the normal state and show a message regarding safe boot. The screenshot below shows how to add this option:
[[File:qui.jpg]]
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Backup fails with error on a 64 Bit system even though VDDK is already installed ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*You receive the warning ''Backup fails with error on a 64 Bit system even though VDDK is already installed''.
'''Possible causes'''
*VDDK is only installed as a 32-bit version.
&rArr; '''Solution'''
*Execute the <tt>set_vddk64.ps1</tt> script to install the 64 Bit version. See also [[SEP sesam backup client for VMware vStorage API#VDDK installation on Windows x64|VDDK installation on 64 Bit Windows]].
</div>
</div>
<div class="mw-collapsible mw-collapsed">
====  Error:  Load VDDK library failed: Cannot load: vixDiskLib.dll ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*You receive the warning '' Error: Load VDDK library failed: Cannot load: vixDiskLib.dll''.
'''Possible causes'''
*VDDK is only installed as a 32-bit version.
&rArr; '''Solution'''
*Execute the <tt>set_vddk64.ps1</tt> script to install the 64 Bit version. See also [[SEP sesam backup client for VMware vStorage API#VDDK installation on Windows x64|VDDK installation on 64 Bit Windows]].
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Backup stops with ''sbc-1500'' error message====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*Backup stops with the message: ''sbc-1500: Error: VixDiskLib_Open() failed: [sesam] sesam_vm/sesam_vm.vmdk:Cannot connect to the host''.
'''Possible causes'''
*The file <tt>vixDiskLib.dll</tt> does not exist in the directory {{sesamroot|\bin\sesam}} of the VMware data mover.
&rArr; '''Solution'''
*Copy the file {{Path|C:\Program Files\VMware\VMware Virtual Disk Development Kit\vixDiskLib.dll}} to {{sesamroot|\bin\sesam}} of your VMware data mover.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
====  Encrypted backup failure ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
* Encrypted backup stops with the warning: ''"Encryption/decryption operation failed"''.
'''Possible causes'''
*Backup was done with bf64 (blowfish 64) encryption.
&rArr; '''Solution'''
*The encryption must be changed from '''bf64''' to '''aes256'''.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== VM Exception: [InvalidRequest] ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*During VM creation with OVF config file, you receive the warning: ''VM Exception: [InvalidRequest]''.
'''Possible causes'''
*The OVF file used to create VM during restore is invalid. For example, the virtual CD-ROM with the ISO file is no longer available.
&rArr; '''Solution'''
*Restore only VM config files.
[[File:New_Restore_Task_VM_config.jpg]]
* Remove the virtual CD-ROM with the ISO from the OVF file.
*The file can be found in the SEP sesam directory: '''{{sesamroot|/var/tmp/_vadp_/<vm name>/<saveset of backup>}}'''
CD-ROM specification part of ovf file
    <Item>
      <rasd:AddressOnParent>0</rasd:AddressOnParent>
      <rasd:AutomaticAllocation>true</rasd:AutomaticAllocation>
      <rasd:ElementName>CD/DVD Drive 1</rasd:ElementName>
      <rasd:HostResource>ovf:/file/file2</rasd:HostResource>
      <rasd:InstanceID>7</rasd:InstanceID>
      <rasd:Parent>4</rasd:Parent>
      <rasd:ResourceType>15</rasd:ResourceType>
    </Item>
* Start the same restore task and restore VM with VMDK
[[File:New_Restore_Task_VM_VMDK_data.jpg]]
*Edit the OVF file of the VM and remove all virtual devices that prevent the creation of the VM.
  svp-3980: Info:    Create VM from OVF file: 'C:\ProgramData\SEPsesam\var\tmp\_vadp_\EX-SERVER\SC20130423113643791@70RYUkBmDGz\EX-SERVER.ovf'
  svp-1901: Error:  VM Exception: [VM creation failed  (error)].
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== VM creation breaks with an error ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*VM creation breaks with the error:
svp-3980: Info:    Create VM from OVF file: 'C:\ProgramData\SEPsesam\var\tmp\_vadp_\EX-SERVER\SC20130423113643791@70RYUkBmDGz\EX-SERVER.ovf'
svp-1901: Error:  VM Exception: [VM creation failed  (error)].
'''Possible causes'''
*Wrong video RAM size. Must be set to 4MB in ''auto-detect'' mode. The error message in host.d is:
opID=49F494FA-000001D6-6a-7b-3e-ec-f4] Video Ram size edit not supported when auto-detect is True ./var/log/hostd.log:2013-04-23T14:43:56.923Z [61B7EB90 info 'vm:/vmfs/volumes/5087d83e-bbbbd91c-4218-001999da71cf/testEX-SERVER/testEX-SERVER.vmx'
opID=49F494FA-000001D6-6a-7b-3e-ec-f4] Reconfigure failed: vmodl.fault.NotSupported
* See: [http://kb.vmware.com/kb/1020796 Creating a protection group or protecting a virtual machine may fail with the error: Operation Not Supported on the Object]
&rArr; '''Solution'''
*Analyse the VMware logs:
** Use vCenter <Administration>, <export system logs> to select the affected ESX-Server as source. Choose <Logs> only from system logs and specify the desired export location.
** Once the export is complete, unzip the tgz file from the export directory then locate the host.d file and search for errors.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Cannot display VMX file ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*Error occurs during download of VMX file.
'''Possible causes'''
*vCenter is not able to download the file due to known issues in older vCenter versions. The problem is described here: [http://kb.vmware.com/kb/1019286 Using the vCenter Server data store browser to download or copy a powered-on virtual machine's .vmx and .nvram files fails]
&rArr; '''Solution'''
*Update your version of vCenter. This problem is not related to SEP sesam but to vCenter only.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Error: Could not load default plugins from /usr/lib/vmware-vix-disklib/lib64/libdiskLibPlugin.so ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*A VADP backup ends with: ''"Error: VM Exception: [Exit code from sbc: [1] - warning]”''
* In the log file you see the warning:
Could not load default plugins from /usr/lib/vmware-vix-disklib/lib64/libdiskLibPlugin.so.
'''Possible causes'''
*The incorrect <tt>LD_LIBRARY_PATH</tt> has been set.
&rArr; '''Solution'''
*Edit <tt>/etc/sesam2000.ini</tt> and add/modify the <tt>LD_LIBRARY_PATH</tt> line:
''For 32-bit Linux'':
  VERSION=4.2.1.41
  SM_BIN_SESAM=/opt/sesam/bin/sesam/
  ...
  LD_LIBRARY_PATH=/usr/lib/vmware-vix-disklib/lib32:/usr/lib/vmware-vix-disklib/plugins32:$LD_LIBRARY_PATH
''For 64-bit Linux'':
  VERSION=4.2.1.41
  SM_BIN_SESAM=/opt/sesam/bin/sesam/
  ...
  LD_LIBRARY_PATH=/usr/lib/vmware-vix-disklib/lib64:/usr/lib/vmware-vix-disklib/plugins64:$LD_LIBRARY_PATH
* If the problem persists after modifying the <tt>sm.ini</tt> and restarting the SEP sesam service, check if the <tt>libexpat.so.0</tt> actually exists on the selected system:
vcenter:/usr/lib64 # ldd /usr/lib/vmware-vix-disklib/lib64/libdiskLibPlugin.so
        linux-vdso.so.1 =>  (0x00007fff539ff000)
        libpthread.so.0 => /lib64/libpthread.so.0 (0x00007fdab6937000)
        libstdc++.so.6 => /usr/lib64/libstdc++.so.6 (0x00007fdab662d000)
        libdl.so.2 => /lib64/libdl.so.2 (0x00007fdab6428000)
        libcrypto.so.0.9.8 => /usr/lib64/libcrypto.so.0.9.8 (0x00007fdab6089000)
        libssl.so.0.9.8 => /usr/lib64/libssl.so.0.9.8 (0x00007fdab5e35000)
        <pre style="color:red">
        libexpat.so.0 => not found
        </pre>
        libz.so.1 => /lib64/libz.so.1 (0x00007fdab5c1e000)
        libtypes.so => not found
        libvmomi.so => not found
        libvmacore.so => not found
        libgcc_s.so.1 => /lib64/libgcc_s.so.1 (0x00007fdab5a07000)
        libc.so.6 => /lib64/libc.so.6 (0x00007fdab5692000)
        /lib64/ld-linux-x86-64.so.2 (0x00007fdab70b0000)
        libm.so.6 => /lib64/libm.so.6 (0x00007fdab5419000)
* Search for the file <tt>libexpat.so.0</tt>:
        vcenter:/usr/lib64 # ls -lart libexp*
        -rwxr-xr-x 1 root root 196944 May 29  2009 libexpect5.44.1.11.so
        -rwxr-xr-x 1 root root 170984 Feb 20  2010 libexpat.so.0.5.0
Result: The file <tt>libexpat.so.0</tt> does not exist
*Resolve the issue:
ln -s libexpat.so.0.5.0 libexpat.so.0
*First control after generating the soft link:
vcenter:/usr/lib64 # ls -lart libexp*
-rwxr-xr-x 1 root root 196944 May 29  2009 libexpect5.44.1.11.so
-rwxr-xr-x 1 root root 170984 Feb 20  2010 libexpat.so.0.5.0
lrwxrwxrwx 1 root root    17 Jul  2  2012 libexpat.so.0 -> libexpat.so.0.5.0
*Second control after generating the soft link:
        vcenter:/usr/lib64 # ldd /usr/lib/vmware-vix-disklib/lib64/libdiskLibPlugin.so
        linux-vdso.so.1 =>  (0x00007fff90f39000)
        libpthread.so.0 => /lib64/libpthread.so.0 (0x00007f83497de000)
        libstdc++.so.6 => /usr/lib64/libstdc++.so.6 (0x00007f83494d3000)
        libdl.so.2 => /lib64/libdl.so.2 (0x00007f83492cf000)
        libcrypto.so.0.9.8 => /usr/lib/vmware-vix-disklib/lib64/libcrypto.so.0.9.8 (0x00007f8349053000)
        libssl.so.0.9.8 => /usr/lib/vmware-vix-disklib/lib64/libssl.so.0.9.8 (0x00007f8348f02000)
        <pre style="color:red"> libexpat.so.0 => /usr/lib64/libexpat.so.0 (0x00007f8348cd8000) </pre>
        libz.so.1 => /lib64/libz.so.1 (0x00007f8348ac2000)
        libtypes.so => /usr/lib/vmware-vix-disklib/lib64/libtypes.so (0x00007f834401a000)
        libvmomi.so => /usr/lib/vmware-vix-disklib/lib64/libvmomi.so (0x00007f83438c6000)
        libvmacore.so => /usr/lib/vmware-vix-disklib/lib64/libvmacore.so (0x00007f8342e34000)
        libgcc_s.so.1 => /lib64/libgcc_s.so.1 (0x00007f8342c1d000)
        libc.so.6 => /lib64/libc.so.6 (0x00007f83428a9000)
        /lib64/ld-linux-x86-64.so.2 (0x00007f8349f88000)
        libm.so.6 => /lib64/libm.so.6 (0x00007f8342630000)
        libcrypt.so.1 => /lib64/libcrypt.so.1 (0x00007f83423f4000)
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Restore of VMDK with transport mode SAN fails ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*Error occurs during restore shortly before all data are written. You receive the warning: ''"Restore of VMDK with transport mode SAN fails with "Write to disk failed: Error 1365799600129 at 4110" or similar message"''.
'''Possible causes'''
*This issue is related to VMware, not to SEP sesam. Ordinarily, this problem only occurs if a VMDK has been created with a capacity value of MB (megabyte) instead of GB (gigabyte) or TB (terabyte) and in this case only if the value of the size is not a integer number (i.e. the value 16.3 MB is not a integer number, but 16 MB is).
&rArr; '''Solution'''
*VMware fixed the problem in version 5.5 of ESXi. If it is not possible to upgrade the ESXi, the restore can be done via all other transport modes (NBD,NBDSSL,HOTADD).
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Restore of VMware machine via SAN with Windows data mover fails ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*Restore fails with the following message immediately after starting data transfer: ''Restore of VMware machine via SAN with Windows data mover fails with "SAN transport error: I/O - Operation failed"''.
2014-10-13 13:32:45: sbc-3925: Info:    VDDK:    INFO: 2014-10-13T13:32:45.260+02:00 [02192 error 'Default'] Incomplete write to, Wanted 65536 Got 0, Error 2 (19)
2014-10-13 13:32:45: sbc-3925: Info:    VDDK:    INFO: 2014-10-13T13:32:45.262+02:00 [02192 error 'Default'] Incomplete write to, Wanted 65536 Got 0, Error 2 (19)
2014-10-13 13:32:45: sbc-3925: Info:    VDDK:    INFO: 2014-10-13T13:32:45.264+02:00 [11876 error 'Default'] San transport error: I/O Operation failed.
2014-10-13 13:32:45: sbc-1031: Error:  Cannot write to remote archive: [VixDiskLib: VixDiskLib_Write: Write to disk failed: Error 17592452332404352 at 4116.
'''Possible causes'''
*The SAN volume on Windows data mover is offline, which implies read only access to this volume.
&rArr; '''Solution'''
*Change the volume status from offline to online by using the Windows disk management tool. Right-click the affected volume and change its status then try again.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== svp-1901: Error:  VM Exception: [Exception=FileFault,dynamictype=null]. -> CBT-RESET needed ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*The above rror occurs when a snapshot is not deleted after a CBT backup.
'''Possible causes'''
*CBT is not in a clean state
&rArr; '''Solution'''
*Reset CBT (see below)
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Resetting CBT via CLI or GUI ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Soft reset (online)'''
*Generally available as of SEP sesam version 4.2.2.26. A soft reset is also possible via GUI and via CLI as of version 4.4.1.x (see below).
*When executing the following command, the virtual machine does not need to be shut down. The command must be executed in the directory <tt><sesam-root>\bin\sesam</tt>:
''Example''
sbc_vadp -b -a "action=softreset,server=ws2008x64,username=Administrator,password=secret" <br>"DC/linuxdbserver"
'''Soft reset (online via GUI or CLI)'''
*A soft reset of CBT is also possible via GUI and CLI as of SEP sesam version 4.4.1.x. This can be done for each task via the GUI. The '''Reset CBT''' button is available on the first tab for each task at '''Tasks -> by Clients''' when opening the properties of a specified task.
*The second option is to use the CLI:
''Example''
sm_cmd resetcbt -S qsbox1 -d "SEP Cloud" -V "cosinus (SEP)"
'''Hard reset (offline)'''
*This command should be used when a soft reset does not work or if it is not available. See the requirements below for further information.
''Example''
sbc_vadp -b -a "action=resetcbt,server=ws2008x64,username=Administrator,password=secret" <br>"DC/linuxdbserver"
'''Hard reset (offline via CLI)'''
*A hard reset is also possible via CLI as of SEP sesam version 4.4.1.x (see below). The syntax for this command is as follows:
''Example''
sm_cmd resetcbt -S qsbox1 -d "SEP Cloud" -V "cosinus (SEP)" -m hard
The virtual machine must be powered off for this action.
'''Manual CBT reset'''
*Alternatively, a CBT-reset can be performed via the vSphere client:
''Online''
*The virtual machine does not need to be shut down to reset CBT:
#Open the properties of the affected virtual machine from '''Tasks > By Clients'''.
#Uncheck '''Enable Change Block Tracking (CBT)''' and save the task.
#Create a snapshot via vSphere Client of the affected virtual machine (none of the ticks needs to be selected).
#Delete the snapshot that was created before.
#In SEP sesam, activate the CBT option in the VM client settings and start the VM backup.
''Offline''
*This step needs to be performed if a reset of CBT in online mode does not work. The virtual machine must be turned off for this step:
#Shut down the VM.
#Open the VMware Snapshot-Manager and delete all snapshots.
#Right-click '''VM -> Edit settings -> Options tab -> General -> Configuration Parameters'''.
#Set the value "ctkEnabled" to false.
#Set the value "scsi0:0.ctkEnabled" to false (NOTE: set the value to ''false'' for each disk).
#Open the folder where the VM <tt>*.VMDK</tt> files exists and delete all <tt>*-CTK.VMDK</tt> files
#Start the VM.
#Shut down the VM (this is required for the CTK table update).
#Start the VM again.
#In SEP sesam, activate the CBT option in the VM client settings and start the VM backup.
</div>
</div>
==SAP Hana==
<div class="mw-collapsible mw-collapsed">
==== Backup finished with error [447]====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*Backup failed with error.
YYYY-MM-DDTHH:MM:SS+00:00  P11252      1480e025c70 ERROR  BACKUP  SAVE DATA finished with error: [447] backup could not be completed, [110507] Backint exited with exit code 1, Traceback (most recent call last):
  File "/usr/local/sesam/lib/python2.7/site-packages/cx_Freeze/initscripts/Console.py", line 27, in <module>
  File "backint_saphana.py", line 124, in <module>
  File "sm_common.py", line 55, in __init__
IOError: [Errno 13] Permission denied: '/var/opt/sesam/var/log/lgc/sbc_backint_NOT DEFINED.log'
'''Cause'''
*The ''hdbbackint'' does not have the permissions to write to the logging directory.
&rArr; '''Solution'''
*Execute <code>chmod 755 (directory)</code> to fix the issue.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== SAP Hana backup failure – analyze log files for cause  ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*Backup was unsuccessful and is shown with a red dot in either the SAP HANA Studio or the SEP sesam GUI.
&rArr; '''Solution'''
*Go to <tt>/var/opt/sesam/var/log/lgc</tt> and search for the ''hdbbackint_SID.log'' or ''hdbbackint_SID_log.log''. These logs contain the logging information for the data connections to the SEP sesam Server and Remote Device Server (if used). On the SEP sesam Server/RDS, <tt><sesam_install>/var/log/sms</tt> will contain ''stpd_pid.log'' and ''stpd_pid.com.log'' files with the server-side logging information. Additional log information on the SEP sesam Server can also be found in <tt><sesam_install>/var/log/lgc</tt> in ''sm_sbc_com*.log'' files.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Job status displays multiple running jobs ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*Even though only a single backup or restore is running, multiple jobs are displayed in the ''Job Status'' view of the SEP sesam GUI.
&rArr; '''Solution'''
*This is the usual behaviour. When performing a backup, HANA bundles the data to be saved into a few separate save sets and sends them to the SEP sesam device server. Therefore, multiple jobs will be displayed in the job status. The same in reverse applies to restores.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Log backups running too frequent ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*Log backups are processed every 15 minutes. The time among log backups should be extended.
&rArr; '''Solution'''
*Open the backup configuration in the SAP HANA Studio. On the right, there is a box where the interval can be adjusted. But be careful: The log area will grow bigger. If the log area is full, the database will stop performing transactions!
</div>
</div>
==NetApp Volume Backup==
<div class="mw-collapsible mw-collapsed">
==== FilerView http might be disabled====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*FilerView might be disabled.
&rArr; '''Solution'''
*Check if FilerView is enabled. Logon to your NetApp system via ''ssh'' and use the following command to check whether your FilerView http is enabled:
options httpd.admin.enable
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Restore shows permission problems ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*A restore fails with the following error message in the protocol:
2012-08-20 12:32:27: sbc-2044: Warning: Cannot create item [/var/opt/sesam/var/work/mnt/netapp/VOLUME_NAME/restore/]: Permission denied
&rArr; '''Solution'''
*Check if the system acting as a data mover has a write access to the NetApp volume the data should be restored to.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Incorrect volume path specification ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*Usually NFS shares on NetApp systems are exported beneath the:
/vol/
directory. For example the nfs share ''test'' is mountable via:
netapp:/vol/test/
This is not the case for all NetApp systems. Some systems export the volume directly via:
netapp:/test/
&rArr; '''Solution'''
*By default, SEP sesam mounts the volume via <tt>/vol/</tt> specification. You can adjust the ''volume_path'' parameter in the advanced backup options by specifying the following:
-a volume_path=/
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Backup fails with ''Permission denied'' - user mapping for NTFS style volumes is missing====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*By default, SEP sesam is accessing the volumes for backup via NFS. If a desired volume for backup has security style set to NTFS, an appropriate user mapping has to be configured on the NetApp system. If not, backup may fail with ''Permission denied'' error message.
&rArr; '''Solution'''
*Map the permission for the administrator user to root as shown in the screenshot below.
[[File:Netapp name mapp.png|left|500px|link=]]
<br clear=all>
</div>
</div>
==MySQL Backup==
<div class="mw-collapsible mw-collapsed">
==== MySQL backup fails with ''mysqldump: Error 2013: Lost connection to MySQL server during query''====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*MySQL backup fails with
mysqldump: Error 2013: Lost connection to MySQL server during query
'''Possible cause'''
*This error typically occurs when backing up MySQL databases to tape devices. The reason for this is the MySQL setting<tt>net_write_timeout</tt>, which defaults to a value of 60 seconds. It can take longer than 60 seconds to open the tape, but after 60 seconds MySQL database resets the connection while the backup is still in progress.
&rArr; '''Solution'''
*Open the option file {{Path|/etc/my.cnf}} and set a higher value for the variable <tt>net_write_timeout</tt> in section <tt>[mysqld]</tt> as follows:
[mysqld]
  ... other options ..
net_write_timeout = 180
*Close the file and restart your ''mysql'' daemon for changes to take effect. If a restart is not an option, the setting can also be applied online, via the <tt>mysql</tt> command:
# mysql -u root -p -e "set global net_write_timeout=180;"
Keep in mind that this setting will reset to its original value during restart if it is not saved in the configuration file.
*If you have raised the value to 180 seconds, but backups are still failing with the same error message, try to use a higher timeout value. The timeout can get exceeded, for example, if the tape gets swapped during the MySQL backup. Note that some tape libraries require more than 180 seconds to handle the tapes.
The current active value can be determined as follows:
<pre># mysql -u root -p -e "SHOW GLOBAL VARIABLES LIKE 'net_write_timeout'"
+-------------------+-------+
| Variable_name    | Value |
+-------------------+-------+
| net_write_timeout | 60    |
+-------------------+-------+</pre>
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Problems during MySQL backup if user's password contains special characters – use configuration file to store the password ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*There may be problems during backup if the password of the user, assigned for executing the backups, contains special characters. In general, the use of apostrophes as well as mutated vowels (umlauts) is suppressed in the GUI.
&rArr; '''Solution'''
*Store the password (recommended for all MySQL backups) in a special configuration file rather than a task. If a password is stored separately in the configuration file, it will not appear in SEP sesam logging. See [http://dev.mysql.com/doc/refman/5.0/en/option-files.html 4.2.3.3. Using Option Files] for a complete overview about MySQL configuration files on any supported platform. The following example is suitable for Unix and Linux:
*Create a configuration file named <tt>my.cnf</tt>. In case SEP sesam runs as user ''root'' and to ensure that the SEP sesam Client can read it correctly, store this file in
/root/.my.cnf
*Enter the following parameters into the file (the entry user is optional):
[client]
user=root
password=mysqlpw
*The backup tasks options must include the user name if not set:
-a user=username
The password will now be read from the configuration file during the backup.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
====  Shell login of user root is permitted (i.e. on Ubuntu systems), but the variable $HOME does not exist  ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*If the variable $HOME does not exist, then the file <tt>my.cnf</tt> cannot be found.
&rArr; '''Solution'''
*Edit the file <tt><sesam-root>/var/ini/sm.ini</tt> and add the following lines at the bottom of the file:
[ENVIRONMENT]
HOME=/root
Once you added the required variable, restart SEP sesam service for changes to take effect.
</div>
</div>
==BSR Pro for Windows==
<div class="mw-collapsible mw-collapsed">
==== No save sets nor clients exist in SEP sesam after clicking ''Execute BSR Pro Quick-Start'' option====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
 
'''Problem'''
*There are no save sets available at the SEP sesam Server.
'''Possible cause'''
*This error typically occurs when the <tt>sm_glbv</tt> variable is not set.
*The resolution in your network does not work as expected, there might be issues with IPv6 and IPv4.
&rArr; '''Solution'''
*Open a shell on the SEP sesam Server and execute the command below. This command enables you to contact the SEP sesam Server even if the reverse name resolution does not work on the new client.
sm_glbv w gv_stpd_auth NONE
*Specify the SEP sesam Server with the FQDN. See also [[How to check DNS configuration]].</div>
</div>
==Other==
<div class="mw-collapsible mw-collapsed">
==== Windows installer (MSI) installation error ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*You receive the following warning: ''"An error occurred during the installation of assembly component... HRESULT: 0x80070bc9."''
'''Possible causes'''
*MSI locks the database for the installation of new software after Windows updates were installed.
&rArr; '''Solution'''
*Reboot the host to unlock the database.
'''Problem'''
* Installation failed after uninstallation
;You receive the following Popup:
* English: "The SEP sesam server was installed using a server installation package. Please retry the update using a server installation package instead of the server package you are using. Update will be aborted."
* Deutsch: "Der SEP sesam server wurde mit einem server Installationspaket installiert. Bitte wiederholen Sie den Update mit einem server Installationspaket statt des verwendeten server Pakets. Das Update wurde abgebrochen."
'''Possible causes'''
* The uninstallation did not remove ''HKLM\SOFTWARE\SEP Elektronik GmbH'' registry key.
&rArr; '''Solution'''
*Open the MS Windows registry (e.g. call regedit) and remove ''HKLM\SOFTWARE\SEP Elektronik GmbH''.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Red Hat Enterprise Linux ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*The following warning occurs on a Windows operating system: ''"ERROR: SMS0004: The specified device does not exist."''
&rArr; '''Solution'''
*Reinstall the "CBMR x.x SEP Sesam Version" software package.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Hyper-V backup ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Message'''
*The following message appears:
Error:  DB Module: [ [Failed at thaw] - VSS_E_WRITERERROR_TIMEOUT.  <br>[Microsoft Hyper-V VSS Writer] - VSS_E_WRITERERROR_TIMEOUT]
&rArr; '''Solution'''
*Install the following Microsoft service pack on the Hyper-V Node and on each Microsoft VM running on that host: http://support.microsoft.com/en-us/kb/2996928
<br>
'''Message'''
*The following message appears:
Error: VSS_E_SNAPSHOT_SET_IN_PROGRESS error and in the Windows Event logs VDS basic provider error
&rArr; '''Solution'''
*Install the following Microsoft service pack on the Hyper-V Node and on each Microsoft VM running on that host: http://support.microsoft.com/de-de/kb/2838669/en-us
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== Powershell script not executed on a target machine ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*Why is the Powershell script not executed on a target machine?
'''Possible causes'''
*By default, Microsoft installs Windows Powershell with the permission set to '''Restricted'''. This setting only allows the execution of commands in Powershell but no scripts.
&rArr; '''Solution'''
*This can be changed with following command in Powershell:
Set-ExecutionPolicy RemoteSigned
For more information, see http://www.technet.microsoft.com/en-us/library/ee176961.aspx
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== VSS ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
SEP sesam uses only the VSS components provided by Microsoft. VSS allows rapid "point-in-time" snapshots of a hard drive for backup.
Follow the instructions below if you encounter a VSS error. Run a test after each step to make sure that the problem has been resolved.
'''1. Windows reboot'''
&rArr; '''Solution'''
*Reboot your Windows. A Windows reboot often eliminates various VSS writer problems.
'''2. Disk space'''
'''Problem'''
*If there is insufficient disk space, VSS snapshots may fails.
&rArr; '''Solution'''
*Make sure that sufficient disk space is available.
'''3. Multiple Backup Jobs with VSS'''
'''Problem'''
*If multiple VSS jobs are started, the operating system reports the following VSS error message:
VSS_E_SNAPSHOT_SET_IN_PROGRESS
'''Possible causes'''
* It is not possible to run multiple VSS snapshots at the same time. Windows can only start a VSS snapshot for each partition.
&rArr; '''Solution'''
*Run the backup jobs from a client sequentially, for example:
** 22:00: Start System Recovery Backup.
** 23:00: Start Custom Path Backup.
*If the temporal separation is not possible, try the following solution. These must be set in the <tt>sm.ini</tt> following settings on the client:
[SBC_OPTIONS]
VSS_WAIT_FOR_ASYNC_OP=180
VSS_DELAY=90
VSS_MAX_RETRY=6
With these settings, the VSS sesam client tries to execute operations sequentially and waits for an active VSS operation. The matching settings may vary depending on system and backup jobs.
'''4. Third-party Backup software'''
&rArr; '''Solution'''
*Check if some nother backup software from different vendor is running on the system, for example:
**Windows Backup, NTbackup
**Acronis, Backup Exec, ect.
Disable this backup software if necessary.
'''5. Remove old VSS snapshots'''
&rArr; '''Solution'''
*Start the CMD command prompt as administrator and type the following command:
vssadmin delete shadows /all
The command cleans up all VSS snapshots of all volumes.
'''6. VSS writer status check'''
&rArr; '''Solution'''
*Start the CMD command prompt as administrator and type the following command:
vssadmin list writers
If a VSS writer error appears, restart the following services:
* Volume Shadow Copy Service
* VSS application writer (Exchange, MS-SQL, Hyper-V)
* COM+ System Application Service
* Distributed Transaction Coordinator Service
Run the command <tt>vssadmin list writers</tt> again and check if the issue has been resolved.
'''7. Windows event log check'''
&rArr; '''Solution'''
*Check the event logs of the Windows Event Viewer. Search for ''VolSnap'' errors corresponding to VSS at the time of the SEP sesam backup job.
*It often helps to search the internet for the event ID of the fault to get an indication of the error cause.
'''8. Re-register VSS and COM+ components'''
'''Step 1:'''
*The following scripts re-register all VSS and COM+ components.
*Copy the follow commands in a new <tt>*.bat</tt> file. Start the batch script in the command line as administrator:
''For 64-bit and 32-bit systems'':
<pre>
cd /d %windir%\system32
Net stop vss
Net stop swprv
regsvr32 ole32.dll
regsvr32 vss_ps.dll
Vssvc /Register
regsvr32 /i swprv.dll
regsvr32 /i eventcls.dll
regsvr32 es.dll
regsvr32 stdprov.dll
regsvr32 vssui.dll
regsvr32 msxml.dll
regsvr32 msxml3.dll
regsvr32 msxml4.dll
regsvr32 Vssapi.dll
regsvr32 Vssui.dll
net start vss
net start swprv
</pre>
'''Step 2:'''
*Copy the follow commands in a new <tt>*.bat</tt> file. Start the batch script in the command line as administrator:
''For 64-bit systems'':
<pre>
Net stop vss
Net stop swprv
regsvr32.exe /i %windir%\system32\eventcls.dll
regsvr32.exe /i %windir%\system32\swprv.dll
regsvr32.exe %windir%\system32\vssui.dll
regsvr32.exe %windir%\SysWOW64\vss_ps.dll
regsvr32.exe %windir%\SysWOW64\msxml.dll
regsvr32.exe %windir%\SysWOW64\msxml2.dll
regsvr32.exe %windir%\SysWOW64\msxml3.dll
regsvr32.exe %windir%\SysWOW64\msxml4.dll
regsvr32.exe %windir%\SysWOW64\ole32.dll
regsvr32.exe %windir%\SysWOW64\oleaut32.dll
regsvr32.exe %windir%\SysWOW64\es.dll
regsvr32.exe %windir%\SysWOW64\comsvcs.dll
vssvc /register
net start swprv
net start vss
net stop winmgmt
regsvr32 wmiutils.dll 
net start winmgmt
</pre>
'''10. VM utility Update'''
&rArr; '''Solution'''
*If the system is a virtual machine, uninstall the installed utility version and start the VM then reinstall the latest VM utility version:
**VMware vSphere: VMware Tools
**Microsoft Hyper-V: Hyper-V Integration Services
**Citrix XenServer: XenServer Tools
'''11. Windows Update'''
&rArr; '''Solution'''
*Install the latest Windows updates, service packs and hot fixes from Microsoft.
* Run a test after the update.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== IBM DB2 ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*There are problems with SEP sesam operations.
&rArr; '''Solution'''
* Check contents of db user's {{Path|$HOME/sqllib/db2dump/db2diag.log}} log file.
* Check the messages on SEP sesam Server.
* Find more information in the ''sdb2'' log. Log filename is set by <tt>XBSA LOGFILE=<Full pathname of sdb2.log></tt> and log level by <tt>XBSA TRACE=1</tt>.
{{note|All sesam XBSA messages have the prefix ''XBSA''. You can set XBSA TRACE to 2 to show more details, but then the log files can become quite large.}}
</div>
</div>
<div class="mw-collapsible mw-collapsed">
==== MacOS ====
<div class="mw-collapsible-content">
<div class="toccolours mw-collapsible-content" style="background-color: #FFFFFF;">
'''Problem'''
*There are problems with SEP sesam operations.
&rArr; '''Solution'''
The Mac installer has its own log messaging system. To view the log files, proceed as follows:
* Execute the installation/update of the client or GUI package step-by-step until you get to the last installer step ''Summary''.
* Go to the ''Installer Menu'' and click '''Window''' ->'''Installer Log'''.
* Select among the following options: '''Show Errors Only''', '''Show Errors and Progress''' or '''Show All Logs'''.
</div>
</div>
</div>
<translate><!--T:8-->
This guide is intended to help you quickly identify and resolve problems and errors during setup, installation and during normal operation of your SEP sesam system. SEP sesam often serves as an indicator that there has been a change or event that impacts overall system performance. Changes in SEP sesam backup performance are often caused by system changes or failures.</translate>
<!--SEP sesam provides two guides to help you resolve any problems you may encounter:
* The ''[[Error Messages Guide]]'' lists error messages alphabetically, provides explanations of the errors wherever possible and suggestions for correcting the problems. Such messages contain an error number that can be used to access this information.
* The ''Troubleshooting Guide'' describes problems as they may arise during the operation of your SEP sesam system, lists possible causes wherever possible and provides solutions to the problems.-->


== See also ==
<translate><!--T:9-->
[[English FAQ|FAQ]]  
{{First steps}}</translate>
<translate><!--T:10-->
{{anchor|interpret_error}}{{:Interpreting Error Messages/en}}</translate>
<translate><!--T:11-->
{{anchor|log_level}}{{:Setting Log Level/en}}</translate>
<translate><!--T:36--> For details on how to set a log level for specific backup or restore task in the GUI or globally for SEP sesam kernel modules, see [[Special:MyLanguage/Setting_Log_Level|Setting Log Level]].</translate>
<translate><!--T:30-->
{{anchor|installation}}{{:Installation and Configuration Troubleshooting/en}}</translate>
<translate><!--T:12-->
{{anchor|backup}}{{:Backup Troubleshooting}}</translate>
<translate><!--T:13-->
{{anchor|disaster_recovery}}{{:Disaster Recovery Troubleshooting}}</translate>
<translate><!--T:14-->
{{anchor|GUI}}{{:GUI Troubleshooting/en}}</translate>
<translate><!--T:15-->
{{anchor|network}}{{:Network Troubleshooting/en}}</translate>
<translate><!--T:16-->
{{anchor|MS_SQL}}{{:MS SQL Troubleshooting/en}}</translate>
<translate><!--T:17-->
{{anchor|Exchange}}{{:MS Exchange Troubleshooting}}</translate>
<translate><!--T:18-->
{{anchor|NetWare}}{{:NetWare Troubleshooting}}</translate>
<translate><!--T:19-->
{{anchor|Oracle}}{{:Oracle Troubleshooting}}</translate>
<translate><!--T:20-->
{{anchor|Informix}}{{:Informix Troubleshooting/en}}</translate>
<translate><!--T:21-->
{{anchor|Lotus_Domino}}{{:Lotus Domino Server Troubleshooting}}</translate>
<translate><!--T:22-->
{{anchor|VMware}}{{:VMware Troubleshooting}}</translate>
<translate><!--T:23-->
{{anchor|Citrix}}{{:Citrix XEN Server Troubleshooting}}</translate>
<translate><!--T:24-->
{{anchor|SAP_HANA}}{{anchor|SAP_Hana}}{{:SAP HANA Troubleshooting}}</translate>
<translate><!--T:37--> {{anchor|SAP_ERP}}{{:SAP ERP Troubleshooting}}</translate>
<translate><!--T:25-->
{{anchor|NetApp}}{{:NetApp Troubleshooting}}</translate>
<translate><!--T:26-->
{{anchor|MySQL}}{{:MySQL Troubleshooting}}</translate>
<translate><!--T:27-->
{{anchor|BSR_Pro}}{{:BSR Pro for Windows Troubleshooting}}</translate>
<translate><!--T:28-->
{{anchor|NDMP}}{{:NDMP Troubleshooting}}</translate>
<translate><!--T:29-->
{{anchor|Hyper-V}}{{:Hyper-V Troubleshooting/en}}</translate>
<translate>
<!--T:35-->
{{anchor|KVM}}{{:KVM QEMU Troubleshooting}}</translate>
<translate>
<!--T:34-->
{{anchor|Si3_dedup}}{{:Si3 Deduplication Troubleshooting}}</translate>
<translate><!--T:31-->
{{anchor|tape}}{{:Tape and Tape Devices Troubleshooting}}</translate>
<translate><!--T:32-->
{{anchor|VSS}}{{:VSS Troubleshooting/en}}</translate>
<translate><!--T:40--> {{anchor|HPE_StoreOnce}}{{:HPE_StoreOnce_Troubleshooting}}</translate>
<translate><!--T:39-->
{{anchor|Proxmox}}{{:Proxmox VE Troubleshooting}}


[[Error Messages Guide]]
== See also == <!--T:33-->
[[Special:MyLanguage/Error_Messages_Guide|Error Messages Guide]]</translate>

Revision as of 10:44, 9 January 2020

Other languages:

Template:Copyright SEP AG en

Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3/4.4.3 Beefalo V2. For previous documentation version(s), check documentation archive.


Introduction

This guide is intended to help you quickly identify and resolve problems and errors during setup, installation and during normal operation of your SEP sesam system. SEP sesam often serves as an indicator that there has been a change or event that impacts overall system performance. Changes in SEP sesam backup performance are often caused by system changes or failures.

Template:First steps Interpreting Error Messages/en Setting Log Level/en For details on how to set a log level for specific backup or restore task in the GUI or globally for SEP sesam kernel modules, see Setting Log Level. Installation and Configuration Troubleshooting/en

Backup problems

Client backup error

Problem 1

Backup of a Windows or Linux client fails with the following error:

"E020-HOSTS   [..] : Error:   Network communication problem: SOCKET error: 10060

Possible causes

The cause of this problem is most likely:

  • The active firewall on the SEP sesam backup Client. In this case, check the firewall settings and if ports 11322 or 11301 are blocked.

On Linux also check if the sesam SSHD daemon is running

ps axw | grep sm_sshd

and if port 11322 is open and in state LISTEN

lsof -i TCP | grep 11322
  • An active antivirus program is blocking access or running its own firewall and blocking access.
  • Third party firewall between the backup server and the backup client blocking access.
  • The SEP sesam Client agent is not running on the system.**Other network related errors.

Problem 2

A client backup did not function properly. How can I determine where the problem is?

Solution
Run the following commands to determine the error:

SEP Warning.png Warning
The following commands produce a high network load.

BACKUP SERVER UNIX, CLIENT WINDOWS

 sm_ctrlc -l system  {client name} sbc -b -s -  f:/test  >/dev/null

Data from the F:/ directory on Windows is written over the network to the directory /dev/null on Unix. To display it, append -v 1 to the command above. Everything written to /dev/null will be displayed.

 sm_ctrlc -l system  {client name}   sbc  -b -s  -  -v 1      f:/test  >/dev/null

BACKUP SERVER UNIX, CLIENT UNIX

 sm_ctrlc -l root  {client name}   sbc  -b -s -  /usr  >/dev/null

To display the read data:

 sm_ctrlc -l root  {client name}   sbc  -b -s -  -v  1   /usr  >/dev/null

BACKUP SERVER WINDOWS, CLIENT UNIX

 sm_ctrlc -l root  {client name}   sbc  -b -s -             /usr    > NUL

With backup data logging:

 sm_ctrlc -l root  {client name}   sbc  -b -s -  -v  1   /usr    > NUL

If the test backup is to be run on the target backup client only, execute the following command:

In the Unix directory <sesam>/bin/sesam/:

 sbc -b -s  -  /usr   >/dev/null

In the Windows directory <SESAM_ROOT>\bin\sesam\:

 sbc  -b -s  -  f:/test    > NUL

Enter -v 1 to show the backed up data on your monitor.

Failed backups will be automatically deleted

Problem

By default, SEP sesam deletes all failed backups after 3 days automatically to release the storage space. How can I keep such backups for a longer time? (< version 4.3.3)

Solution

If you want to keep your failed backups for more than 3 days, you may manually extend the backup EOL (expiration date) of this particular saveset. For details, see Manually extending EOL. Note that SEP sesam automatically retains the last successful backup saveset when the next backup fails. This means that SEP sesam extends the EOL of the previous 'successful' or 'with warnings' backup, thus ensuring that at least one successful backup is retained.

Failed to write the data to media during backup

Problem

During backup, operating system error "23 (ERROR_CRC)" is displayed.

Possible cause

The tape drive cannot write proper blocks onto the backup media.

Solution

Check the tape drive and backup media.

Backup to data store fails

Problem

Backup (or migration) to data store fails with the error message All available space of media is used, stop writing to media.

Possible cause

SEP sesam aborts a data transfer because less than 1 GB is available on the data store (disk storage). A disk failure can also cause this problem.

Solution The following points may help to resolve the problem:

  • Check the system messages on Linux or the event log on Windows for any hardware problems.
  • Remove orphaned savesets from the data stores by using the Clean up option, see Data Store.
  • Delete some savesets or backups on this datastore or start a purge process for the data store to delete the obsolete (EOL-free) savesets and to get enough free space. For details, see Purging a Data Store.
  • Increase the disk space.
  • Run FSCK on the disk storage.

If you cannot solve this issue, report it to SEP sesam support. The support team will then provide you further instructions.

Incorrect login or password

Problem

During backup, the message "Login incorrect. Password incorrect" is displayed.

Solution

Check your name resolution (DNS or etc/hosts file). The SEP sesam Server and SEP sesam Client must be reachable with or without FQDN and should be able to resolve each other correctly, including the reverse lookup. If the resolution is correct, do the following:

  1. In the SEP sesam GUI, go to Main Selection -> Tasks -> By Clients, and select the client with the backup problem.
  2. Open the backup properties and click the Options tab.
  3. Type -v 4 at Save options.
  4. Start the backup again, then go to Main Selection -> Job state -> Backups and double-click the backup task to open its properties.
  5. Go to Logging -> Day log and search for the line Login incorrect. Password incorrect then correct the name resolution.

Data transfer via FTP fails with XBSA Initialisation error

Problem

At the beginning of a backup data transfer via FTP, the following error message appears:

- XBSA Initialisation error. Access to the requested object is not possible. NEGATIVE reply: 425 Can't open data connection. WINSOCK: Connection timed out. (0x274c,10060)

Possible causes

This problem can be caused by the following:

  • Active firewall on the system that is supposed to transfer the backup data between SEP sesam Server and Client.
  • Routing or Network Address Translation (NAT) between the systems involved.

Solution

The following steps can help to solve the problem:

  • In the case of a firewall problem:
    • Disable the firewall.
    • Adjust the firewall application-based. This needs to be done on system, which should transfer the data. SEP sesam uses active FTP. When starting regular file backups on Windows add binary sbc.exe to the firewall exclude list. In case of BSR on Windows also add binary oodiag.exe to the firewall exclude list.
    • Customize the firewall port-based. Make sure that all required ports are available on the system and are not blocked by a firewall. If a port range is open, it is important that you configure that port range in the STPD options for the client. For details, see Port numbers for SEP sesam Client.
  • In case of a router/NAT, adjust the rules to allow SEP sesam RDS and Client to transfer data.

Network connection failure on physical or virtual systems

Problem

SEP sesam backup of physical or virtual systems fails due to network connection error (10054). The log files contain one of the following error messages:

10054 An existing connection was forcibly closed by the remote host

or

Error : Network communication problem: SOCKET error: 10054 - The virtual circuit which reset by the 
remote side . recv () call failed.

For more details on Windows error codes, see Microsoft Developer Network documentation.

Possible causes

Cause 1: Virtualization solutions

Citrix XenTools and VMware Tools may create their own network card driver on a virtual machine, which will be used instead of the regular Windows system drivers.

The paravirtual network drivers may cause some problems:

  • General CPU load of approx. 30% within a VM without any actions
  • Very poor throughputs, even in disconnected networks or gigabit LANs
  • Broken connections

According to Microsoft documentation, the above error message shows that the connection was reset by the client, i.e., the system to be backed up.

The problem is at the same time visible on the SEP sesam Server:

  • The backup remains in the active status with a 0 GB/h performance.
  • There are active sm_sms_backup processes.
  • There are active sm_stpd processes.

SEP sesam has no feedback from the client that the backup was aborted. The connection has been hard reset.

Cause 2: Network/Port trunking

In several customer environments, port trunking was disabled either on the system to be backed up or on the backup server side. After the trunks were resolved, the backups could be performed without problems.

To resolve trunking issues, see Trunking configuration guide.

Cause 3: Firewall

If network disconnection occurs in less than 5 minutes, is most likely a TSO/trunking issue described above. If the network disconnects after 5, 60 or 120 minutes, there is a KeepAlive problem with the NAT/PAT router or a firewall.

Cause 4: Virus scanner

Virus scanners intervene actively in the data transmission and related processes and may thus be the cause of the problem. It is recommended to use the antivirus exclusions for SEP sesam as they can have adverse effects on backup and restore operations, as described in Antivirus Exclusions for SEP sesam.

Cause 5: Error on the SEP sesam Server side

If a problem with the process sm_stpd.exe or sm_stpd occurs is recorded in the event viewer or the dmesg output of a SEP sesam Server at the time the backup is aborted, the problem must be analysed from the SEP sesam Sever side. Note that incorrect routing can also be the cause of this problem.

For example, the SEP sesam Server and SEP sesam Client are on two different networks. Routing is not controlled by one central router but via static routes on the other network. A ping from the SEP sesam Server to the client works, but not vice versa. In such case, the permanent route to the client's network was set on the SEP sesam Server, but it was not part of the active routes.

To solve this problem, delete and re-add the route as follows:

route delete <client_network>
route add -p <client_network> mask <network_mask_of_the_client_network> <SEP_sesam_Server_IP>

Cause 6: Disabling task offloading

For VMs

Disable the TSO (TCP Segment Offloading) feature in the VM.

Both Citrix XenServer and VMware ESXi use the existing TSO in the network cards. This feature allows you to swap out different operations that must be performed during the fragmentation of network packets to the network interface card (checksum calculation). The purpose of this is to reduce the CPU load. (The XenServer network card drivers (NIC) are more affected by this problem.)

On Windows

To disable this feature on Windows, the key DisableTaskOffload has to be set in the registry to prevent offloading to the network card, see Microsoft documentation. After setting this option on the backup client and then restarting, further backups run without any problems.

On Linux

On Linux, you can activate or deactivate the TSO settings during runtime using the ethtool tool as follows:

ethtool -K eth0 tso off

TCP retransmission

Fixing TCP retransmission errors at the network level fixes the root cause of the problem. To find TCP retransmission errors, the network analysis tool Wireshark is required.

You have to start a network analysis with Wireshark on the affected system (Capture -> Interfaces).

Information sign.png Note
Retransmission error appears as black lines in the Wireshark log.

ON WINDOWS

Information sign.png Note
SEP sesam uses Microsoft’s Volume Shadow Copy Service (VSS) to perform backup for various task types. VSS failures are typically caused by system configuration and not by SEP sesam; this section may provide some instructions on how to troubleshoot such issues. If you cannot find your issue here, check also VSS Troubleshooting or refer to Microsoft's article Volume Shadow Copy Service for more detailed information on VSS.

Path backup on Windows is not working

Problem

SEP sesam Server failed to execute a path backup of a Windows client (however, a path backup without VSS is working). The following error is displayed:

Problem while loading dynamic link library: [WIN32 API error: 1114 - A dynamic link library (DLL) 
initialization routine failed. LoadLibrary() call failed for: [vss.dll]].

Possible causes

  • Typically, when dll cannot be initialised, a running antivirus solution is preventing it.
  • The client's VSS configuration is incorrect.

Solution

  • Disable the antivirus software during backup.
  • Check the client's VSS configuration by running the following commands:
    • vssadmin list writers - check the status of all writers on a daily basis
    • vssadmin list shadows - check existing VSS copies
    • vssadmin list shadowstorage - check how much space is reserved and available space for VSS
    • vssadmin resize shadowstorage - set the reserved space for VSS snapshots to unlimited

WIN32 API error: "1450"

Problem

  • What should I do when a client backup fails with a WIN32 API error: "1450 - Not enough system resources to execute the requested service"?
  • The backup of a client may end with the following error message in the backup log:
sbc-1148: Error:   W2KSS Error: [WIN32 API error: 1450 - Not enough system resources to execute 
the requested service. Cannot store registry key: [SOFTWARE]. RegSaveKey() call failed in BackupRegistry().].

Possible cause

Insufficient size of the registry/paged memory area. This problem affects SEP sesam as well as other backup tools, such as NTBackup.

Solution

The Microsoft article Backup program is unsuccessful when you back up a large system volume explains approaches for different versions of Microsoft Windows.

Unsuccessful backup of OneDrive files

Problem

SEP sesam is unable to access files in OneDrive remote storage. When attempting to back up files stored in OneDrive, SEP sesam log file displays the following warning:

Warning: Unable to open item - Access to the cloud file is denied.

Cause

OneDrive is a cloud-based service provided by Microsoft for storing, synchronizing, and sharing files. It has some unique characteristics that are specific to Microsoft's ecosystem and access to files is implemented differently than standard cloud solutions. SEP sesam may encounter difficulties in accessing and backing up the files that are stored in OneDrive cloud-like remote storage.

Solution

To resolve this issue, consider using the "offline mode" and syncing the files from OneDrive to local storage on the client device. This enables SEP sesam to bypass the issues with access and files are backed up from the local storage rather than the cloud. Ensure that you regularly update the local copy to reflect the changes in the cloud storage.

System state backup is backing up large amount of data due to DFS

Problem

When performing a Windows system state backup on the server that runs DFS (Distributed File System), large amount of data is backed up and the backup is slow.

Possible cause

If the DFS replication is enabled, the system state backup may include all the data from the DFS Replication service too.

Solution

Information sign.png Note
On a Domain Controller (DC) the DFS is used to replicate the SYSVOL, therefore it should be included in the system state backup. Use the following procedure only as a workaround if your system state backups are slow due to large amount of DFSR data.

Exclude the DFS writer from the system state backup task in the SEP sesam GUI: from the Main Selection -> Tasks -> By clients, select your Windows client then double click on your system state backup task. In the properties window switch to the Options tab, and under Additional call arguments -> Backup options exclude the DFS writer as follows:

-x "VSS:/DFS Replication service writer"

Next, you have to back up the file system data, served by the DFS, separately by performing a regular Path backup (create a Path task type instead of a System_state backup task). For details, see Backing up System State.

System_State backup (RegLoadKey) error

Problem

  • What does the warning "The system cannot find path. RegLoadKey()..." during System_State backup mean?
  • You may see the following output in NOT-log:
C:\Program Files\SEPsesam\var\tmp\usr_wf_S-1-5-21-220523388-1123561945-839522115-1003].
2020-04-13 02:04:20: sbc-2074: Warning: W2KSS Warning: [WIN32 API error: 3 -
The system cannot find path. RegLoadKey() call failed for
file: [C:\Documents and Settings\nn\ntuser.dat] in BackupUserProfiles().].

Possible cause

There are inconsistencies in the OS configuration. The reason is that a user profile has been deleted but the user account still exists. System_State backup is looking for files corresponding to the user in the file system but the files no longer exist.

Solution

  • Delete the user in question or restore the profile date in the file system.
  • Check the following in your registry to see whether it still includes references to usernames which no longer exist:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProfileList

Access denied during Microsoft Windows backup via VSS

Problem

Why does a Microsoft Windows backup via VSS stop with the message "[CVssBaseObject::CreateVssBackupComponents] - Access denied"?

Possible cause

SEP sesam is not allowed to create a snapshot with the current user.

Solution

Check the user running the SEP sesam daemon and make sure that the user has all permissions to access the volume(s).

Stream data length exceeds buffer capacity

Problem

What does the warning "Stream data length bigger than buffer can accept. Input buffer length = [65536], Stream data size = (High part)[0] (Low part)[65564]" ?

Possible cause

SEP sesam uses 64 kB to back up Windows ACL files and folders and one object exceeds this buffer. You can use the Windows command icacls to display the ACL of a file or folder. The output looks like this:

C:\>icacls "C:\Documents and Settings\LocalService\Local Settings\Temp"
C:\Documents and Settings\LocalService\Local Settings\Temp NT AUTHORITY\LOCAL SERVICE:(I)(F)
                                                           NT AUTHORITY\LOCAL SERVICE:(I)(OI)(CI)(IO)(F)
                                                           NT AUTHORITY\SYSTEM:(I)(F)
                                                           NT AUTHORITY\SYSTEM:(I)(OI)(CI)(IO)(F)
                                                           BUILTIN\Administrators:(I)(F)
                                                           BUILTIN\Administrators:(I)(OI)(CI)(IO)(F)
Successfully processed 1 files; Failed processing 0 files

If you get several hundred or thousand lines, there is something wrong with the ACL.

Solution

Reset the permissions of the file's respective folder by using the command:

C:\>icacls "C:\Documents and Settings\LocalService\Local Settings\Temp" /reset

This command inherits the permissions of the parent object. You may have to adjust the permissions after running this command if manual settings have been applied for this object.

Backup on Windows 7 did not complete successfully

Problem

When you perform a Windows 7 backup, the backup might fail with one of the following errors.

sbc-1146: Error:   DB Module: [WIN32 API error: 55 - The specified network resource or device is no longer available.
sbc-2040: Warning: Cannot read item [\\?\GLOBALROOT\Device\HarddiskVolumeShadowCopy730\Windows\winsxs\x86_microsoft-windows-sort_31bf3856ad364e35_6.1.7600.16385_none_ab9479767ad67fd7\sort.exe: (2) WIN32 API error]:[ 2 - The system cannot find the file specified. ]. Padding remaining bytes...
smk-3506: Info:     Backup finished. Status: ERROR Error: Item generator returns [WIN32 API error: 2 - The system cannot find the file specified. ] for item [\\?\GLOBALROOT\Device\HarddiskVolumeShadowCopy136\Windows\winsxs\FileMaps\]
smk-3506: Info:     Backup finished. Status: ERROR Error:   DB Module: [Not all items have been processed]

To see more detailed error, view the Event Log on your Windows client: Event Viewer -> Windows Logs -> System. The Event Id 33, volsnap shows the following message:

The oldest shadow copy of volume C: was deleted to keep disk space usage for shadow copies of volume C: below the user defined limit.

Possible causes

  • There was not enough disk space for the Volume Shadow Service to take a snapshot; consequently, the operating system automatically deleted the snapshot due to the lack of space.
  • This error occurs if the snapshot size exceeds the snapshot Maximum size: Use limit configured for the volume.

Solution

Check the Maximum size: Use limit on your Windows 7 client: Open a Windows Explorer on the client and right-click the drive letter to open the drive properties. Select the Shadow copies tab -> Settings -> check the Maximum size: Use limit:

  • If you select No limit, Windows will not delete the snapshot regardless of how much space it consumes. Note, however, that in case of a large snapshot the process might be failing to create the snapshot because there is not enough disk space left on the respective drive.
  • If you specify Use limit, change the maximum size limit to a large enough value to contain the snapshot with room to spare. According to Microsoft, it is recommended to set the maximum size limit to a value that equals 10% of the volume size. For example, if the C:\ drive has 100 GB of data, the limit should be set to 10 GB. Or, you can store the shadow copy data on another disk. For details, see Microsoft forum answers Shadow Copy.

ON LINUX

SEP sesam Linux Client error during backup

Problem

A SEP sesam Linux Client (SBC) issues an error or warning during backup.

Possible causes

Backup on Linux may finish with an error or warning if:

  • the size of a file has changed during the backup
  • a file is deleted during the backup (between 'find' and data processing)
  • the 'find' function encountered an error

Solution

  • To avoid these warnings and resolve the above errors, double-click the backup task to open its properties and under the Options tab in the Backup options field enter the following command:
-o ignore_finderr=<regex>|ALL
  • If you want to avoid all such errors/warnings, specify:
-o ignore_finderr=ALL

GVFS error during Linux backup

Problem

  • If a user is logged on to the gnome or kde session and makes use of the GVFS layer, the directory ~/.gvfs is created. This directory cannot be entered by any other user (even root).
  • Additionally, the system call "stat" also errors out on this directory. The directory cannot be excluded, because while creating the file list and looking at the excludes, sbc_find once does a "stat()" call on the directory and receives an error.

Solution

  • Create a new file named /etc/profile.local with the contents below /etc/profile.local:
GVFS_DISABLE_FUSE=1 
export GVFS_DISABLE_FUSE
  • Run the following commands for each affected folder:
    • fusermount -u /home/$USER/.gvfs
    • test with stat /home/$USER/.gvfs


Disaster recovery on Linux

Problem with a ReaR backup execution

Problem

  • SEP sesam Client package was successfully installed and path backups are working. If you have problems executing a ReaR backup check the backup log if there are some missing dependencies.
  • Example:
    There are binaries or libraries in the ReaR recovery system that need additional libraries
    /opt/sesam/bin/sesam/libvirtmod.so requires additional libraries (fatal error)
    	libvirt.so.0 => not found
    

Cause

  • In this case the package libvirt-client is missing.

Solution

  • Depending on your distribution, install libvirt-client as follows:
    • On RHEL/CentOS 7 use the command: yum install libvirt-client
    • On SLES 12/15 use: zypper install libvirt-client

The workflow mkrescue is not supported in the ReaR system

Problem

  • The workflow mkrescue is not supported in the ReaR rescue/recovery system.

Solution

  • Delete the file /etc/rear-release.

ReaR image hangs during bootup

Problem

  • The system hangs during bootup like shown in the following image:
  • Rear-hang.jpg

Solution

  • Boot the system with the ACPI=OFF option (this option can be specified on the command line in the boot menu prompt, after the options BACKUP=SESAM OUTPUT=ISO).

The recovered system does not boot

Problem 1

  • The system does not boot because /root/dev/console cannot be found.

Possible causes

  • Certain distributions rely on the existence of the directory /dev/ while booting
  • Certain static devices must exist before the udev daemon creates them.

Solution

  • Include the /dev/ file system in your backup.
  • If the restore cannot restore /dev/:
  1. Boot from the SEP sesam LIVE CD.
  2. Mount the ROOT partition of the restored system.
  3. Manually create the /dev/ directory.
  4. Manually create the /dev/console entry with:
mknod /path/to/target/mount//dev/console c 0 0

Problem 2

  • The system does not boot because of missing libblkid.so.1.

Possible cause

  • This is most likely caused by SELinux which is activated by default.

Solution

  • Especially on RHEL6 or CentOS6 systems, follow these steps after rebooting from the ReaR recovery:
    1. Press a key when prompted by the boot loader (GRUB):
    2. Rhelcentos grub1.jpg
    3. Select the appropriate boot loader entry:
    4. Rhelcentos grub2.jpg
    5. Press e to modify the commands for the selected entry:
    6. Rhelcentos grub3.jpg
    7. Add selinux=0 to the commands:
    8. Rhelcentos grub4.jpg
    9. Press Enter to confirm the changes and b to boot up the machine with SELinux disabled.
    10. When having access to the system, change the option SELinux of /etc/selinux/config to the following:
    11. SELINUX=permissive

    Afterwards, reboot the system and feel free to set the SELinux value back to enforcing if needed.

No bootable operating system can be found

Problem

  • The system is not able to find a bootable OS instance after the restore.

Possible causes

  • There may have been problems during the installation of the GRUB boot loader.

Solution

  • The restore protocol includes a statement whether or not the installation of the boot loader was successful:
2009-12-14 14:48:27: sbc-3500: Info:     Reinstall boot manager
[/sesam/bin/sesam//sbc_grub_auto /mnt/disk/ AUTO]

  • It is also possible to boot the system again from the live-CD, mount the target partitions and use grub-install to install the boot loader correctly.

The device does not have a corresponding BIOS drive

Problem

  • During the restore, the following error occurs:
/dev/sda1 does not have any corresponding BIOS drive

Possible causes

  • Check the file /boot/grub/device.map on the target system. If there are entries referring to the disk through /dev/by-disk/... as shown in the example below, the entry is most likely the reference to the hard disk partition of the broken system. GRUB will not find the proper device:
hd(0) /dev/disk/by-id/ata-SAMSUNG_SP2504C_S09QJ1GLA14263-part1

Solution

  • Reboot from the live-CD
  • Mount the root and boot partitions to /mnt/disk (and /mnt/disk/boot, if necessary)
  • Restart grub-install with the following options:
grub-install --root-directory=/mnt/disk --recheck hd0

Output:

grub-probe: error: Cannot open `/boot/grub/device.map'
/usr/sbin/grub-install: line 374: [: =: unary operator expected
Installation finished. No error reported.
This is the contents of the device map /mnt/disk/boot/grub/device.map.
Check if this is correct or not. If any of the lines is incorrect,
fix it and re-run the script `grub-install'.

(hd0)   /dev/hda
(hd1)   /dev/hdb

You can ignore the error line 374: [: =: unary operator expected.
More important is the result Installation finished. No error reported.

No corresponding BIOS drive for /dev/cciss/c0d0p2

Problem

  • You receive the message: /dev/cciss/c0d0p2 does not have any corresponding BIOS drive in restore log.

Solution

fsck.ext3: File system has unsupported features

Problem

  • During a restore of a system with kernel version 2.4 the system may not boot because the Live-CD creates a file system with features which are not supported by kernel 2.4.

Possible causes

  • Most likely the file system options resize_inode,dir_index,large_file,ext_attr are causing the problem and making the system unbootable.

Solution

  • Reboot from the Live-CD image, which includes the tool debugfs.
  • Show the file system features with debugfs:
root@recover#: debugfs -w /dev/sda2
debugfs 1.41.1 (01-Sep-2008)
debugfs:  features
Filesystem features: has_journal ext_attr resize_inode dir_index filetype needs_recovery sparse_super large_file
quit

Replace /dev/sda2 with the corresponding partition names on your system.

  • To remove file system features:
root@recover#: debugfs -w /dev/sda2
debugfs:  features -resize_inode -ext_attr -dir_index -large_file -needs_recovery -sparse_super
Filesystem features: has_journal filetype
quit

After removing the options, the system should boot correctly.

Incorrect inode size (256)

Problem

  • After a successful restore the boot process stops with incorrect inode size (256).

Possible causes

  • Older kernel versions (2.4) may use a different inode size than the one the file system's created through the Live-CD (which includes kernel 2.6). For example, this happens during the restore of SLES8 based systems which use an inode size of 128k.

Solution

  • This can only be solved by formatting the devices manually from the Live-CD, using the proper mkfs options:
mkfs.ext3 -I 128 /dev/sda1

After this step, remount the partition to /mnt/disk and repeat the restore operations. Changing the inode size is only possible by reformatting the devices.

Missing root file system

Problem

  • The restored system can't find a root file system and fails during resume.

Possible causes

  • The /etc/fstab file was configured with the root file system as UUID.

Solution

  • Specify the root file system device name in conventional device names if you are using a different physical disk. After booting, use YAST to reconfigure your boot loader or edit your /boot/grub/menu.lst manually:
root=/dev/sda2

Missing network cards

Problem

  • The restored system does not find any network cards.

Possible causes

  • If the restore was done to dissimilar hardware, SLES-based distributions may not configure the network devices correctly. SLES-based systems save their network configuration by using the system's MAC address. Most likely the system will not use eht0 as a device name, but eth1, as it has another MAC address.

Solution

  • Use YaST and reconfigure your network interfaces.

Client does not start on the RHEL6/Debian9 recovery image

Problem

  • The SEP sesam Client does not start automatically on RHEL6 and Debian9-based recovery images.

Cause

  • The file /etc/init.d/functions is missing within the recovery image.

Solution

  • The client can be started manually via:
/opt/sesam/bin/sesam/sm_main start


RHEL7-related issues

RHEL7 backup fails with an error

Error 1

  • The RHEL backup fails with the following error:
ERROR: The LSB package is not installed.

Solution

  • Install the lsb package as follows:
yum install redhat-lsb-core mkisofs syslinux


Error 2

  • The RHEL backup fails with:
ERROR: Cannot find required programs: mingetty

For more details, see Rear dependencies on RHEL7.


Solution

To solve this problem, proceed as follows:

  1. Edit
  2.  /var/opt/sesam/var/lib/rear/usr/share/rear/conf/default.conf

    and from the line:

    # required programs. Same as above, but if they are missing, we abort.
     REQUIRED_PROGS=(
     "$SCRIPT_FILE"

    remove the line:

     mingetty
  3. Run the backup again.

ReaR error occurred during grub2-mkimage of bootx64.efi

Information sign.png Note
In order to be able to create an UEFI/EFI bootable ISO image, the additional tool ebiso has to be installed on the client system as described in the section Installing ebiso for creating UEFI aware ISO images.

Problem

  • The ReaR error occurrs during grub2-mkimage of bootx64.efi.

Solution

  • To solve the problem, install the grub2-efi-x64-modules package.

SLES-related issues

SM_SSH does not work on SLES11 recovery image

Solution

  • In this case, execute
mount -t tmpfs none /dev/shm/ -o rw,nosuid,nodev,noexec
before starting the recovery process.

Client is unreachable after booting the rescue image

Problem

  • After booting the rescue image the client is not reachable.

Solution

  • Start the client manually using the following command on the rescue command line:
sh /etc/scripts/system-setup.d/59-start-sesam-client.sh

EFI bootable image cannot be created on SLES11

Problem

  • EFI bootable image of GRUB2 cannot be created on SLES11.

Cause

  • SEP sesam v. 4.4.3.64 Grolar is the last version that supports SLES11 with UEFI.

Solution

  • To continue using SLES with UEFI, you should not upgrade to a later version of SEP sesam.

Installing ebiso for creating UEFI aware ISO images

In order to be able to create an UEFI/EFI bootable ISO image the, the additional tool ebiso has to be installed on the client system. This package is not part of a regular SLES12/SLES15 installation and can be downloaded at the following URL:

http://download.opensuse.org/repositories/Archiving:/Backup:/Rear/SLE_12/x86_64/

or

http://download.sep.de/utils/bsr-linux/

For other Linux distributions contact SEP support at support@sep.de for assistance.

Install ebiso as follows:

rpm -i ebiso-<version>.rpm

Note that in ReaR v. < 1.19, the generated ISO image mount migt be too small for storing all needed information and need to be adjusted.

In this case, under

/var/opt/sesam/var/lib/rear/usr/share/rear/lib/uefi-functions.sh (line 64)

change

(shim.efi|elilo.efi) size=128000 ;;

to

(shim.efi|elilo.efi) size=228000 ;;


GUI Troubleshooting/en Network Troubleshooting/en MS SQL Troubleshooting/en

Microsoft Exchange Server

Exchange backup fails with VSS API error due to missing Microsoft Exchange VSS writer

Problem

When backing up Exchange, the backup fails because the Microsoft Exchange VSS writer required for backup is missing. The following error occurs:

sbc-1178: Error:   VSS API error: 
CVssServer::CreateSnapshot: No volume could be determined.
sbc-1146: Error:   
DB Module: [BackupProcessing: For the specified backup source no volumes could be 
determined. Sources - \Microsoft Exchange Writer]
sbc-3052: Info:    
Items processed correctly: [0]. Not processed or incorrectly processed items: [0]. 
(SF20160503083743700@BLljg0gnWAa)
sbc-1156: Error:   Operation failed!
sbc-3001: Info:    Exiting.

This error occurs when one or more writers required for backup are missing or not available. Note that this is not the same as VSS error or failed VSS. In the latter case, check Common VSS problems.

A writer is consider missing, if running (as administrator) the Microsoft command-line tool vssadmin list writers shows no available Microsoft Exchange VSS writer. If a VSS writer is missing, all backups that use that writer to perform VSS snapshots will fail. A missing writer is a failure of the Windows operating system. To fix this issue, Windows registry needs to be edited. SEP sesam cannot back up any data until the required VSS writers are available.

Solution

Information sign.png Note
SEP sesam is not responsible for any issue caused by Windows registry editing. Note that only experts should edit the registry, as using Windows registry editor incorrectly can cause serious problems, such as Windows to stop working. For more information on editing Windows registry, see Windows registry information for advanced users.
It is advised to back up the registry before making any change to it. It is also recommended to perform the following procedure outside of working hours as it requires restarting the Microsoft Exchange Information Store service.

To enable Microsoft Exchange VSS writer, on the Exchange server open and edit the registry with the following key value:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MSExchangeIS\ParametersSystem\
"Disable Exchange Writer" DWORD=0

If the key already exists with a value of 1, change the value to 0. (Value 1 disables the Microsoft Exchange Writer.) For more information on enabling VSS Exchange writer, refer to How to turn on the Exchange writer for the Volume Shadow Copy service (it is marked as relevant for Windows Small Business Server 2003, but the procedure can also be applied to later versions).

Then restart the Microsoft Exchange Information Store service:

  1. Log in to the Exchange server and click Start.
  2. Enter services.msc in the search box, and press Enter. The Services window opens.
  3. From the list of services, right-click the Microsoft Exchange Information Store service (MSExchangeIS), and then click Restart. Note that during restart the users will be disconnected from Exchange.

After restarting Exchange, in the command prompt enter vssadmin list writers and verify that the VSS writers are listed. Then run your Exchange backup again.

Exchange logs truncation errors

Problem

The Exchange logs are not truncated or the log files are missing.

Cause

Exchange database log truncation is part of Exchange services. SEP sesam notifies Exchange Writer of each successful backup of Exchange Server and Exchange DAG nodes. SEP sesam does not manage or delete Exchange logs and is therefore not responsible for truncating logs, Microsoft Exchange Writer is. SEP sesam only notifies Exchange of the backup status and then:

  • In configurations without DAG, Exchange Writer truncates the transaction log files after a successful full or incremental backup.
  • In DAG replicated configurations, log truncation is delayed by the replication service until all required log files have been replayed into all other copies. The replication service deletes the backed-up log files from both the active and the copy log file paths after verifying that the log files have been successfully applied to the copy database and that both the active database and the database copies checkpoint have passed the log files to be deleted.

Solution

To verify that Exchange log truncation has been called, check the Applications and Services Logs and look for errors related to the Exchange VSS or Replica writer.

Check ESE events with ID:

  • 224: This event indicates that logs are being deleted and denotes the associated database.
  • 225: This event indicates that there are no logs available for truncation (either ESE cannot determine whether the transaction log files have been committed to the Exchange Server database, there are not enough logs or Circular Logging is enabled).
  • 299: The replication service truncates the log stream and removes transaction logs that are no longer needed (or reports that there is not a minimum amount of logs for truncation).

If the Exchange configuration uses DAG, the replication process between the different nodes can prevent log truncation in case of errors. These errors are indicated with the event source MSExchangeRepl.

Below are some entries from the application log in the Event Viewer (for a list of errors, see the Microsoft article MSExchangeRepl Errors and Events):

· Event ID 224 (ESE) MDB01 deleting log files C:\ExchVols\MDB01\Log Files\E0000000001.log to C:\ExchVols\MDB01\Log Files\E000000002B.log.
· Event ID 225 (ESE) MDB01—no log files can be truncated; will be logged instead of Event ID 224 when circular logging is used.
· Event ID 2046 (MSExchangeRepl) VSS writer has successfully completed the backup of database MDB01.
· Event ID 2006 (ESE) MDB01 shadow copy completed successfully.
· Event ID 2033 (MSExchangeRepl) VSS writer has successfully processed the backup completion event.
· Event ID 2037 (MSExchangeRepl) VSS writer backup has been successfully shut down.

If errors occur in connection with the Exchange VSS or Replica Writer, check the Exchange configuration to determine the cause and resolve the errors. Such errors cannot be caused by SEP sesam, but until they are resolved, Exchange cannot truncate the log files, resulting in filling up the volume or disk where they reside.

Also check the current status of the VSS writer by running the following at an administrative prompt on the Exchange server:

   vssadmin list writers

If the writer is missing or is in a failed state, reboot the Exchange server and verify that it is now listed and showing as stable. Then restart the SEP sesam Exchange backup task and check the log truncation.

Exchange Recovery Pro asks for License

If you have started Exchange Recovery Pro the first time you get prompted to install the license. If you use several different Windows users, you get this prompt for every user.


NetWare

Checking the reachability of the TSA services

Problem 1

  • Determining all available TSAs of a NetWare/OES Server.

Solution

  • On a NetWare Server (the sbc_smdr command must be executed on a OES Linux machine with the sesam-novell-client package installed (up to OES2015) or on a OES2018 server (the sesam-novell-client is already included in the SEP Sesam SLES12 Linux Client package):
 #> /opt/sesam/bin/sesam/sbc_smdr -D -N "nw1:::admin.admins.mydomain:novell:0" "/NetWare"
 2007-03-21 16:42:50: sbc-3500: Info:     ::/NetWare
 2007-03-21 16:42:50: sbc-3036: Info:     
 # @(#)SESAM BACKUP CLIENT FOR NETWARE FILE SYSTEMS, VERSION: 1.8R3 
 Build: 1.161 20070320 17:31:00 Linux i386 abas #
 2007-03-21 16:42:50: sbc-3074: Info:     Backup start time [20070321164250]
 2007-03-21 16:42:50: sbc-3500: Info:     Starting Session "SESAM SBC_NLM Session" ...
 2007-03-21 16:42:52: sbc-3500: Info:     NW1.NetWare File System 
 "NW1.NetWare File System" d_ 2000.01.01 00:00:00 2000.01.01 00:00:00 4096 - ,
 2007-03-21 16:42:52: sbc-3500: Info:     NW1.Novell Directory 
 "NW1.Novell Directory" d_ 2000.01.01 00:00:00 2000.01.01 00:00:00 4096 - ,

In this case, the TSAFS (NW1.NetWare File System) and TSANDS (NW1.Novell Directory) are loaded.

  • On an OES(2)-Linux server:
 #> /opt/sesam/bin/sesam/sbc_smdr -D -N "oesnix1::oesnix1:backup:novell:0" "/NetWare"
 2007-03-21 15:55:01: sbc-3500: Info:     ::/NetWare
 2007-03-21 15:55:01: sbc-3036: Info:     # @(#)SESAM BACKUP CLIENT FOR NETWARE FILE SYSTEMS, VERSION: 1.8R3 Build: 1.161 20070320 17:31:00 Linux i386 abas #
 2007-03-21 15:55:01: sbc-3074: Info:     Backup start time [20070321155501]
 2007-03-21 15:55:01: sbc-3500: Info:     Starting Session "SESAM SBC_NLM Session" ...
 2007-03-21 15:55:01: sbc-3500: Info:     OESNIX1.GroupWise System 
 "OESNIX1.GroupWise System" d_ 2000.01.01 00:00:00 2000.01.01 00:00:00 4096 - ,
 2007-03-21 15:55:01: sbc-3500: Info:     OESNIX1.Linux File System
 "OESNIX1.Linux File System" d_ 2000.01.01 00:00:00 2000.01.01 00:00:00 4096 - ,

The TSAFSGW (OESNIX1.GroupWise System) and TSAFS (OESNIX1.Linux File System) are loaded.

Problem 2

  • Determining the sources (resources) of a Target Service File System.

Solution

  • Depending on your installed services, these TSA's are visible:
    • NetWare File System
    • Linux File System
    • GroupWise System
    • Novell Directory
    • iFolder Store
    • Linux Cluster File System
    • NetWare Cluster File System
SEP Tip.png Tip
To enable debug mode for TSA, see Enabling the Debug Options in TSAFS on OES Linux.

Unable to browse or backup a NetWare Server

Problem

  • It is not possible to browse or back up a NetWare Server.

Possible causes

  • No TSA is loaded, or
  • The wrong data mover was inserted.

Solution

  • Restart the NetWare file system with unload TSAFS and load TSAFS.
  • Edit the properties of the NetWare Server in SEP sesam and adjust the data mover in the NetWare Access tab.

When using OES 2018 SP2 with SMDR/TSA, the TSA backup may fail

Problem

  • When using OES 2018 SP2 with SMDR/TSA, the following problem occurs: If two TSA modules (e.g., tsafs and tsands) are loaded via smdr.conf, one of them does not work. Consequently, the TSA backup may fail under certain circumstances.

Workaround

  • Start only one TSA module via smdr.conf, the other module should be loaded manually later. As this is a Micro Focus bug, see the Micro Focus community issue smdr on OES2018SP2 not working for more details.

Sesam Error: Client returns no data

Problem

  • The following error message appears in /var/log/messages on OES Linux client:
 nds_nss_GetGroupsbyMember: failed to init socket, status = 0
 nds_nss_GetPwdbyName: init sock returned 0
 nds_nss_GetPwdbyName: init sock returned 0
 nds_nss_GetPwdbyName: init sock returned 0

Possible causes

  • Incomplete or wrong eDirectory LUM configuration.
  • eDirectory Server certificate is invalid/expired.

Solution

  • Fix the lum setup so that eDirectory authentication can complete.
  • Use iManager and check and/or recreate the server certificates.

Error messages during a backup

Message 1

(0XFFFDFFD7) "Login denied".

Possible causes

  • Invalid username or password.
  • eDirectory Server certificate is invalid/expired.

Solution

  • Edit the properties of the client in SEP sesam and adjust the login data in the NetWare Access and Novell SMS tabs.
  • Use iManager and check and/or recreate the server certificates.

Message 2

(0XFFFDFFCD) "A data stream cannot be opened." "Unable to open a data stream."

Possible causes

  • The user does not have permission to access all data.

Solution

  • Change the user name or adjust the permissions.

Message 3

(0XFFFEFFCC) "Could not write an object to NDS or write to a stream"

or

(0XFFFEFFB1) "Connection to remote host is lost. Remote host might have disconnected."

Possible causes

  • The TSA or the smdr deamon is not running.

Solution

  • Check TSA with opt/novell/sms/bin/smsconfig -t.

Message 4

(0XFFFDFFDC) "An invalid path was used."

Possible causes

  • A wrong backup path was used or the TSAFS was loaded in an incorrect mode.

Solution

  • In the event of --tsamode=dual, it is possible to simply use a Linux path.
  • The source NetWare server backs up all existing volumes respectively.
  • "VOL-NAME:" backs up a specific volume when using --tsamode=netware.
  • The option --tsamode=linux supports path to the volumes/volumename only.
  • In the event of a restore, insufficient access rights could be a reason for this message.

Files are locked after backup, server freezes

Problem

  • Files are locked for several minutes after a backup and the server freezes spontaneously, requiring a reset.

Solution

  • Update the sesam-novell-client to a higher version to solve this problem.

File-based backup is faster than Novell volume backup

Problem

  • The file-based backup is faster than the Novell volume backup.

Solution

  • Disabling the TSA-cache will increase the performance of a Novell-based backup and also decrease the system load.
  • Edit the file /etc/opt/novell/sms/tsafs.conf, change the line "cachingmode=enable" to "cachingmode=disable" and apply the settings with rcnovell-smdrd restart.

Checking the performance and availability of a NSS volume via tsatest on OES2

  • Back up the resource '/' using the supplied credentials.
tsatest -u root -p unsecure
  • Back up the resource /home using the supplied credentials.
tsatest --path=/home -u root -p unsecure
  • Back up the NetWare target SYS:\SYSTEM on ACME_SERVER using the supplied credentials.
tsatest -s ACME_SERVER -v SYS: --path=SYSTEM -u root -p unsecure
  • Back up the '/' resource using the supplied credentials and a buffer size of 131072 bytes.
tsatest -b 131072 -u root -p unsecure
  • Back up the resource '/' on server ACME_SERVER using the supplied credentials. This will perform a remote backup if ACME_SERVER is not the server on which tsatest is loaded/executed.
tsatest -s ACME_SERVER -u root -p unsecure

To check the performance on a NetWare Server, use these instructions: http://support.novell.com/docs/Tids/Solutions/10092890.html


Oracle

Testing the Oracle extension with sbttest on AIX does not work

Problem

  • Testing the Oracle extension with sbttest on AIX will not work unless the full path to the library with argument -libname is specified.

Solution

  • When running sbttest on AIX, specify the full path to the library with argument -libname, e.g.,
    sbttest test1 -libname /opt/sesam/bin/sesam/libobk.so or ... -libname $ORACLE_HOME/lib/libobk.so.

Errors when attempting to perform a backup on AIX

Problem

  • Running RMAN command on AIX ends with errors.

Solution

  • RMAN command on AIX requires that the full path to the library is set in the script via PARMS SBT_LIBRARY={full_path_to_libobk.so}. For details, see RMAN specific parameters.

Rerunning the sbttest script ends with duplicate key error

Problem

  • When rerunning the sbttest script with the same backup_file_name parameter, SEP sesam returns duplicate key error.

Cause

  • This happens because the sbttest is using the same backup_file_name argument on the next run. SEP sesam interprets backup_file_name as the save_set_id and compares it with the IDs in the results table. When the same save_set_id is found, SEP sesam returns duplicate key error.

Solution

  • When running sbttest, make sure that the backup_file_name argument is set to a different value for each run of the script.

Running bash script on AIX results in bad interpreter: No such file or directory error

Problem

  • When running a bash script, a bad interpreter: No such file or directory error message is shown, for example:
-sh: ./sbc_oracle_rman.sh:
/bin/bash: bad interpreter: No such file or directory

Cause

  • Typically, on AIX bash is not included in the list of valid shells.

Solution

  • Change the first line in sbc_oracle_rman.sh to
    #!/bin/sh.

ORACLE_HOME and ORACLE_SID variables are not set in the user environment

Problem

  • If ORACLE_HOME and ORACLE_SID are not defined, SEP sesam script cannot connect to the target database.

Solution

Set ORACLE_HOME and ORACLE_SID variables using any of the following:

  • Add the lines
    export ORACLE_HOME=/u01/app/oracle/product/10gR2/db_1 and export ORACLE_SID=PROD_DB.
  • Use oraenv to set the appropriate environment, for example:
export ORACLE_SID=TEST
export ORAENV_ASK=NO
. oraenv

SAP Oracle: "item from input file does not exist"

Problem

  • brbackup backint log on Windows reports "item from input file does not exist". The following error messages appear:

In backint_<SID>.log

 SSB:(3620): 121043: backint_back.c:( 331):: WARNING: item from input file does not exist: F:\ORACLE\T11\SAPDATA1\ERPUSR_1\ERPUSR.DATA1.

In sbc_<SID>.log

 SSB:(3620): 121242: backint_func.c:(1928):: 2013-06-18 12:12:42: sbc-3008: Info:    Processing item: [F:\ORACLE\T11\SAPDATA1\ERPUSR_1\ERPUSR.DATA1]...
 SSB:(3620): 121242: backint_func.c:(1928):: 2013-06-18 12:12:42: sbc-4000: Trace:   GetFileSecurityInfo: Opening file [\\?\F:\ORACLE\T11\SAPDATA1\ERPUSR_1\ERPUSR.DATA1] with CreateFileW() function failed. Error code: 1314
 SSB:(3620): 121242: backint_func.c:(1928):: 2013-06-18 12:12:42: sbc-2046: Warning: Cannot get item security data for [F:\ORACLE\T11\SAPDATA1\ERPUSR_1\ERPUSR.DATA1].

Possible causes

  • The user starting the brbackup process does not have permission to access the security data (ACL) of the file F:\ORACLE\T11\SAPDATA1\ERPUSR_1\ERPUSR.DATA1 in Windows. Typically, only local group administrators have permission to read or write an object's SACL, which is controlled by the privilege or user right (SeSecurityPrivilege).

Solution

  • Assign the user to the local administrator group of the SAP server.
  • Ensure that the user right (SeSecurityPrivilege) is implicitly or explicitly given to the user.
  • It may also be necessary to set the User Account Control Settings to Never notify through the Control Panel.

The RMAN file name is too long

Problem

  • You receive the warning:
ORA-19506: failed to create sequential file, name="full_COMP1_1953897796_55938_1.bck", parms=""

Possible causes

  • The file name of the backup set created by the RMAN is longer than 32 characters. For example, if the Oracle backup file format is set to format 'full_%d_%I_%s_%p.bck', when the parameter %s (backup set number) is integrated into the filename, the backup set number increases with every backup. As a consequence, the count of characters of that string will increase. Increasing the number to over 32 characters will cause the backup to fail.

Solution

  • Make sure that the character length of the backup set does not exceed 32 characters.


Informix Troubleshooting/en

HCL (IBM) Domino Server

The Lotus Domino (previously Lotus Notes) corporate brand has been first acquired by IBM and then by HCL Technologies. The Lotus Domino product name is now HCL Domino server; however, SEP sesam documentation update (such as screenshots) to reflect these changes is being done in a phased manner, therefore HCL Domino may still appear under the name Lotus Notes, Lotus Domino or IBM Domino.

Failed update of SEP sesam Server with HCL Domino extension module

Problem

The SEP sesam update fails when attempting to update HCL Domino extension on a SEP sesam Server that also acts as the data-mover. An error may occur during the update process, related to the export of the $PATH variable from the sm.ini file. During the update, SEP sesam exports the variables from the sm.ini without replacing the real values of the PATH variable.

Solution

Comment out the PATH variable in the sm.ini file. Open the sm.ini file, typically located in the SESAM_BIN directory, locate the line with the PATH variable and comment out this line by adding a hash symbol (#) at the beginning of the line.

After commenting out the PATH variable, attempt to update SEP sesam again. Once the update is successful, you can revert the changes in the sm.ini file if necessary.

HCL Domino Server backup reports recovery failure

Problem

  • Backup reports "Recovery may fail" during backup of the SEP sesam extension for HCL Domino Server. During the backup, the following warning appears for several or all Notes databases:
sbc-2076: Warning: 
Item [D:\notus03data\mailboxes\mail1\cruoff.nsf] is not logged. 
Recovering may fail.

Possible causes

  • There may be two reasons for this:
  1. Transactional logging was not turned on or is not in Archived mode.
  2. Transactional logging is running in Archived mode but is explicitly turned off for this database in the options of the database.

Solution

  • This message is a warning of the Notes Backup API and is only forwarded by SEP sesam. Turn on Transactional logging in general or just for this database.

Other than that, the message can be ignored. The warning is given during the backup for safety reasons because only the admin can determine if administrative intervention is necessary.

Insufficient temporary space

Problem

  • Temporary space may not suffice because every database must first be copied to the client.

Solution

  • Change the path gv_rw_tmp in <SESAM_VAR>/ini/sm.ini to a directory with sufficient space.

Transactional logging not active

Problem

  • The INCR backups fail.

Solution

  • Activate Transactional logging in Archived mode for Notes.

Transaction logs already in progress

Problem

  • This message appears in the SEP sesam:
DB Module: [Archiving of transaction logs already in progress.]

Possible causes

  • The HCL Domino API sends this message to show that the transactional logs are already in the state Backup. The state cannot be set twice. If a backup could not be completed successfully, this state mat appear.

Solution

  • To finish the backup status, all logasio processes should be removed from the Notes system:
 UNIX:     killall -9 logasio
 WINDOWS:  sm_kill logasio
  • Alternatively, you can reboot the Notes server.

Backup reports incorrect transactional logging

Problem

  • After the restore of Transactional logging, Notes reports incorrect Transactional logging.

Solution

  • Delete the nlogctrl.* files in the log directory then restart the Notes server.

Server fails to restart after a Notes server crash

Problem

  • After a crash of the HCL Domino server, the server cannot be started without rebooting.

Solution

  • If a server crash occurs during a log backup ,logasio processes may remain active. These processes must be stopped. The server can be restarted after running the following command:
 UNIX:     killall -9 logasio
 WINDOWS:  sm_kill logasio

Backup with missing options

Problem

  • The restore of Notes on a Linux client ends with:
 "RESTORE STATUS: Restore failed. 2007-05-02 08:52:32:
  sbc-1146: Error:    DB Module: [Notes API NotesInitExtended() failure"

Possible causes

  • The restore options are not identical to the backup options.

Solution

  • Set the restore options according to the task. Additionally, the options can be set in the restore assistant in step Options under Advanced restore options. For example:
 -v 3 -a USER=nadmin -a NOTESINI=/srv/notedata/notes.ini

Abnormal termination of the sbc.exe process

Problem

  • HCL Domino Console repeats: "C:\..\SEPSesam\bin\sesam\sbc.exe Process has terminated abnormally".

Possible causes

  • If there is a backup failure that causes the SEP sesam backup client to terminate abnormally, the failure will be noticed by the HCL Domino server API and repeat this error message every minute in its logging.

Solution

  • Stop the Domino server forcibly by running nsd -kill.

Restoring Notes database files to different location doesn't work

Problem

  • When doing a restore of database files as a Notes restore to a different file location under Notes_Data, all databases are skipped.

Possible causes

  • Notes denies an access to an existing database with the same replica-id, e.g.:
Item [\JOBSCHED.NJF] not included. Skipped...

Solution

  • In the SEP sesam restore wizard, select a file location outside of Notes_Data and store the database file there. This makes it possible to copy the file to the Notes data directory structure.


VMware vStorage API

Backup

Virtual machines residing on NFS storage are unresponsive during a backup

Problem

  • When using NFSv3 to mount NFS data stores and performing VMware backup in HotAdd transport mode, the VM that is backed up is not reachable for approx. 30 seconds when the HotAdd data mover detaches the VMDK.

Cause

  • This issue occurs when the target VM and the data mover are running on two different hosts (ESXi), and the NFSv3 protocol is used to mount NFS data stores.

Solution

  • To avoid this problem, the VMware data mover and VM have to run on the same ESXi.
  • Use the NFSv4 protocol to mount NFS data stores.

VMware vSphere backup on Linux fails due to VDDK error

Problem A VMware vSphere backup (on the SEP sesam Server or RDS) on Linux fails with the following error:

Load VDDK library failed: Cannot load: libvixDiskLib.so

Cause The VMware Virtual Disk Development Kit (VDDK) is not installed.

Solution Install the VMware Virtual Disk Development Kit (VDDK).

VMware backup or browsing of VMware vCenter fails with an error due to a Java VM security restriction

Problem

  • VMware backup or browsing of VMware vCenter might fail with the following error:
Error:   VM Exception: [VI SDK invoke exception:javax.net.ssl.SSLHandshakeException: java.security.cert.CertificateException: Certificates does not conform to algorithm constraints].

Cause

  • Due to advanced security settings, the Java virtual machine does not allow connection to VMware vCenter.

Solution

  • To avoid the Java virtual machine security restriction, proceed as follows:
  1. On your SEP sesam Server, locate the following file in the Java installation directory:
  2.  JDK_HOME/jre/lib/security/java.security
  3. Change the line
     jdk.certpath.disabledAlgorithms=MD2, RSA > 1024

    to

     jdk.certpath.disabledAlgorithms=
  4. Once done, restart the SEP sesam service.

Segmentation fault during VMware backup on Linux-based data movers

Problem

  • VM backup on Linux-based data mover completed successfully, however a segfault event is recorded.

Cause

  • This is the VMware library issue caused by the missing /sys/class/scsi_disk directory on the Linux system.

Solution

  • Before executing the VMware backups on Linux-based data movers, use the modprobe command modprobe sd_mod to load the sd_mod kernel module and make the /sys/class/scsi_disk directory available.

VMware slow backup performance via NBD. OR: Backups are failing in SAN transport mode with VMs residing on VMFS 6.0

Problem

  • Slow backup performance via NBD. Another problem is that backups might fail in SAN transport mode.

Cause

  • vSphere 6.5 and 6.7 may have slow backup performance via NBD with VDDK 6.0.x due to the VMware policy concerning backward and forward compatibility for VDDK to support N-2 and N+1 releases.
  • With vSphere 6.5 neither of VDDK 6.0.x versions provides SAN transport support when using datastores formatted with new VMFS 6.0 filesystem. Consequently, the backup will fail.

Solution

  • On Windows, VDDK is installed automatically during the SEP sesam installation. However, if you use a new vSphere version you should check the VDDK Compatibility Matrix to find its corresponding VDDK version and install it manually, if required.
  • On Linux, you have to install the required VDDK version manually. Note that every new release of vSphere has a corresponding VDDK version; typically, the version number of VDDK matches the version number of vSphere.

For details on the required version, see VDDK Compatibility Matrix.

VMware backup fails with error due to unrecognized extended LUN connected to a Linux data mover

Problem

  • VMware backup fails with error, such as:


Error while reading data. Error: VixDiskLib: VixDiskLib_Read: Read 2048 sectors at 0 failed. Error 16000 (One of the parameters supplied is invalid) (DiskLib error 4096062: One of the parameters supplied is invalid) at 5024.

Cause

  • On the Linux data mover in VMware environments, when you extend LUN while online (without restarting your Linux system), the extended LUN will not be instantly visible from the Linux operating system. The extended disk is automatically adjusted on Windows, while on Linux you need to rescan SCSI bus manually. Consequently, the backup will fail.

Solution

  • To rescan SCSI bus on Linux without restarting it, use the following command when adding a new disc (X is the number of SCSI host to scan):
echo  “- – -” > /sys/class/scsi_host/hostX/scan
  • Use the following command when expanding an existing disc:
echo 1 > /sys/class/scsi_device/device/rescan

Single file restore

Mounting VMware saveset on Linux fails with error

Problem

  • Mounting VMware saveset (on the SEP sesam Server or RDS) on Linux fails with an error, for example:
Client mount tools not installed

Cause

  • The guestmount tool is not installed on the Linux host.

Solution

  • To be able to access and mount the file system of an image on Linux, you have to use use the guestfs-tools. Install the guestfs-tools package as described in Installing guestfs-tools on Linux.

Single file restore is not working with VMware 6.0

Problem

  • When restoring single files on VMware 6.0, the restore fails with: Cannot open Thin/TBZ disks in a multiwriter mode.

This log is also shown in the vCenter events.

Cause

  • This error appears if the SCSI bus sharing type on the proxy machine is set to Physical.

Solution

  • Shut down the proxy machine and change the type of SCSI bus sharing to None, so the virtual disks cannot be shared by other virtual machines.

When restoring a single file, SEP sesam cannot access storage on a VM that is configured with the SCSI LSI Logic SAS adapter

Problem

  • In SEP sesam version ≥ 4.4.3.48 in combination with a Linux proxy VM, when trying to select the restore source in the restore wizard (step 4: Select Files), no items are displayed in the browser.

Cause

  • This issue seems to be related to the SCSI controller of the proxy VM. When trying to restore a single file from a virtual machine, SEP sesam cannot access storage on a virtual machine that is configured with the SCSI LSI Logic SAS adapter.

Solution

  • Open the properties of the proxy VM in your vCenter and change the controller on the VM from the LSI Logic SAS controller (on some VMs, this is selected by default) to an LSI Logic Parallel controller.

For more information, see VMware Docs article Change the SCSI Controller Type in the vSphere Client.

  • Restart the restore wizard. If there are still no items displayed in the restore browser, reboot the proxy VM and then click the Update button.

After updating an existing SEP sesam structure with a new VDDK version, it is no longer possible to mount a VMDK

Problem

  • After VDDK ≥ 6.5.x has been manually installed on Windows, it is no longer possible to mount a VMDK saveset on this host.

Cause

  • If another VDDK version, for example VDDK ≥ 6.5.x, is manually installed on Windows, the host requires a reboot after the update if you want to mount a VMDK on this host.

Solution

  • Reboot the host after the VDDK update, then run the following script from the command line:

vstor2install.bat in directory C:\Program Files\VMware\VMware Virtual Disk Development Kit\bin


Citrix Hypervisor

Error when using quiesced snapshots

Problem

  • Using VM.snapshot_with_quiesce method fails in Citrix Hypervisor ≥ 8.1 or in the version ≥ 9.0.x.x drivers.

Cause

  • VSS and quiesced snapshots of Windows VMs capability have been removed in Citrix Hypervisor ≥ 8.1 and in the version ≥ 9.0.x.x drivers. They are only supported in Citrix Hypervisor ≤ 8.0.

Solution

  • If you want to continue using the quiesced snapshot feature with Windows VMs hosted on Citrix Hypervisor 8.0 and earlier, do not update to the 9.0.x.x drivers.

CBT backup fails because Hypervisor TLS certificate contains wrong IP address

Problem

  • CBT backup fails with the NBD client connection error:
Failed to get NBD client for device '******: NBD client connection error: hostname '****' doesn't match u'******

Cause

  • The TLS certificate of a Xen Server contains the wrong IP address. Therefore no NBD session can be established.

Solution

  • Check all Citrix Hypervisors in the Pool whether the IP address in the certificate matches.
  • On the Citrix Hypervisor where it does not match, execute the following commands:
  1. Create a backup of the existing certificate by using
  2. mv /etc/xensource/xapi-ssl.pem /etc/xensource/xapi-ssl.pem.$(date -u +%Y%m%d)
  3. Create a new certificate
  4. /opt/xensource/libexec/generate_ssl_cert /etc/xensource/xapi-ssl.pem <ip-address or FQDN> 
  5. Restart XenAPI service
  6. systemctl restart xapi
  7. Restart NBD Service
  8. systemctl restart xapi-nbd 

Message "Upload to URL ... failed" appears during restore, "insufficient space" error occurs during backup

Problems

  • Restore fails with an error:
"Upload to URL ... failed."
SR_BACKEND_FAILURE_44: : There is insufficient space to create snapshot on Storage Repository. 

Possible cause

  • There is not enough space available on the default storage.
  • If the "insufficient space" error occurs during the backup, it might be related to the snapshot process. XenServer was unable to create a snapshot for the VM because there was not enough space in your Storage Repository.

Solution

  • Use XenCenter to select another default storage that has enough free disk capacity to store the virtual disk(s).

Other issues

  • Some errors are not reported in detail by XEN API. More information can be found in XenServer in /var/log directory.
  • In some pool configurations all pool members must have their management interface listed in DNS.
  • If the settings below don't agree on asynchronous routing and connection drops and/or 3 second or 80 second delays, opening sockets may occour. This is very similar to having 2 network cards configured with ipv4 to the same subnet and connected to the same switch.
  • If you use Cisco switches and you have configured (Citrix unsupported) lacp bonding 802.3ad, it is very important that both sides agree on the balancing type. The Linux default is layer2 and the Cisco default is layer3+4.
  • Check the bonding mode on the host with cat /proc/net/bond/bond* for bonding mode:
IEEE 802.3ad Dynamic link aggregation
Transmit Hash Policy: layer2 (0) or Transmit Hash Policy: layer3+4 (1).
  • Users have reported that this command and a reboot solves the problem, but this cannot be formally recommended due to its untested and unsupported status:
xe pif-param-set uuid=${UUID_OF_BOND_PIF} other-config:bond-xmit_hash_policy=1 

SAP HANA

After initial configuration the first test backup out of the HANA Studio shows errors

Problem

  • Once you configured SAP HANA to work with SEP sesam and start the first test backup, it finishes with errors.

Cause

  • There might be an issue with case sensitive file paths, written in the /var/opt/sesam/var/ini/backint_saphana.utl files.

Solution

  • Open the /var/opt/sesam/var/ini/backint_saphana.utl files and make sure that the directory names are listed in the appropriate case (lower case or upper case respectively).

SAP HANA backup fails as sbc_hana.sh tries to back up SAP HANA DB on a secondary system

Problem

  • sbc_hana.sh does not recognize the secondary SAP HANA server as the secondary system and attempts to back up the SAP HANA database. Backup fails with error Connection refused.

Cause

  • The secondary SAP HANA DB cannot be backed up as it permanently synchronizing data with the primary SAP HANA DB. Only the primary system is able to access the database when the database is running in SYNC mode. Therefore accessing the secondary system and running the backups on the replication target will fail.

Solution

Not enough streams for SAP HANA external backups

Problem

  • SAP HANA external backups can no longer be performed due to the following error:
2018-07-26 08:04:35 W007-SBC_COM[  6664]: Timeout reached, drive group HANA has no free streams anymore

Cause

  • There are not enough streams available to run SAP HANA external backups.

Solution

  • In the data store properties, check the available streams per drive (by default, 5) and adjust them to 20.

SAP HANA backups are not started anymore

Problem

  • After a while SAP HANA backups are not starting.

Solution

  • Connect to the SAP HANA server and stop the client:
  1. /opt/sesam/bin/sesam/sm_main stop
  2. ps –ef | grep sm_sbc*
  3. Search for old sm_sbc* services and kill these services.
  4. Start the SEP sesam Client again with the command /opt/sesam/bin/sesam/sm_main start.

Backup finished with error [447]

Problem

  • Backup failed with error.
YYYY-MM-DDTHH:MM:SS+00:00  P11252      1480e025c70 ERROR   BACKUP   SAVE DATA finished with error: [447] backup could not be completed, [110507] Backint exited with exit code 1, Traceback (most recent call last):
 File "/usr/local/sesam/lib/python2.7/site-packages/cx_Freeze/initscripts/Console.py", line 27, in <module>
 File "backint_saphana.py", line 124, in <module>
 File "sm_common.py", line 55, in __init__
IOError: [Errno 13] Permission denied: '/var/opt/sesam/var/log/lgc/sbc_backint_NOT DEFINED.log'

Cause

  • The hdbbackint does not have the permissions to write to the logging directory.

Solution

  • Execute chmod 755 (directory) to fix the issue.

SAP HANA backup failure – analyze log files for cause

Problem

  • Backup was unsuccessful and is shown with a red dot in either the SAP HANA Studio or the SEP sesam GUI.

Solution

  • Go to /var/opt/sesam/var/log/lgc and search for the hdbbackint_SID.log or hdbbackint_SID_log.log. These logs contain the logging information for the data connections to the SEP sesam Server and Remote Device Server (if used).

On the SEP sesam Server/RDS, <sesam_install>/var/log/sms will contain stpd_pid.log and stpd_pid.com.log files with the server-side logging information. Additional log information on the SEP sesam Server can also be found in <sesam_install>/var/log/lgc in sm_sbc_com*.log files.

Job status displays multiple running jobs

Problem

  • Even though only a single backup or restore is running, multiple jobs are displayed in the Job Status view of the SEP sesam GUI.

Solution

  • This is the usual behaviour. When performing a backup, HANA bundles the data to be saved into a few separate save sets and sends them to the SEP sesam device server. Therefore, multiple jobs will be displayed in the job status. The same in reverse applies to restores.

Log backups running too frequent

Problem

  • Log backups are processed every 15 minutes. The time among log backups should be extended.

Solution

  • Open the backup configuration in the SAP HANA Studio. On the right, there is a box where the interval can be adjusted. But be careful: The log area will grow bigger. If the log area is full, the database will stop performing transactions!

After recovery the hardware key changed

Problem

Solution

  • This is a known issue which can occur even if there is no change in the hardware and hostname with the same configuration: re-installation, restore, recovery, or rename will change the hardware key. Please contact SAP support. For details, see Hardware Key for the HANA Database.


SAP ERP

Using XUSER MaxDB tool for authentication during backup fails with the error XUser not found!

Problem

  • The SAP MaxDB XUSER command-line tool can be used to store user log-on data thus simplifying logon to databases. When using XUSER and the script runs as command event, the backup script reports the following error: XUser not found!

Cause

  • The SAP MaxDB XUSER tool creates a file .XUSER.62 in the home drive of the corresponding user. If the script runs as command event, no environment is set and thus also not the HOME variable. If the HOME variable is not set, the DB cannot find the .XUSER.62 file belonging to the user and cannot map and verify the key to the user, therefore the command event fails.

Solution

  • Export the HOME variable for the root user in the backup script (command event script) as follows:
#!/bin/bash
HOME=/root
export HOME
/.../dbmcli .... -U <key> ....
.....


NetApp Volume Backup

FilerView http might be disabled

Problem

  • FilerView might be disabled.

Solution

  • Check if FilerView is enabled. Logon to your NetApp system via ssh and use the following command to check whether your FilerView http is enabled:
options httpd.admin.enable

In clustered environments or Ontap 8 Versions using Vserver:

vserver services web modify -vserver <NODE_NAME> -name ontapi -enabled true

Restore shows permission problems

Problem

  • A restore fails with the following error message in the protocol:
2012-08-20 12:32:27: sbc-2044: Warning: Cannot create item 
[/var/opt/sesam/var/work/mnt/netapp/VOLUME_NAME/restore/]: Permission denied

Solution

  • Check if the system acting as a data mover has a write access to the NetApp volume the data should be restored to.

Incorrect volume path specification

Problem

  • Usually NFS shares on NetApp systems are exported beneath the /vol/ directory. For example the nfs share test is mountable via: netapp:/vol/test/

This is not the case for all NetApp systems. Some systems export the volume directly via: netapp:/test/

Solution

  • By default, SEP sesam mounts the volume via /vol/ specification. You can adjust the volume_path parameter in the advanced backup options by specifying the following:
-a volume_path=/

Backup fails with Permission denied - user mapping for NTFS style volumes is missing

Problem

  • By default, SEP sesam is accessing the volumes for backup via NFS. If a desired volume for backup has security style set to NTFS, an appropriate user mapping has to be configured on the NetApp system. If not, backup may fail with Permission denied error message.

Solution

  • Map the permission for the administrator user to root as shown in the screenshot below.

Netapp name mapp.png


MySQL

MySQL backup fails with mysqldump: Error 2013: Lost connection to MySQL server during query

Problem

  • MySQL backup fails with
mysqldump: Error 2013: 
Lost connection to MySQL server during query

Possible cause

  • This error typically occurs when backing up MySQL databases to tape devices. The reason for this is the MySQL setting net_write_timeout, which defaults to a value of 60 seconds. It can take longer than 60 seconds to open the tape, but after 60 seconds MySQL database resets the connection while the backup is still in progress.

Solution

  • Open the option file /etc/my.cnf and set a higher value for the variable net_write_timeout in section [mysqld] as follows:
[mysqld]
 ... other options ..
net_write_timeout = 180
  • Close the file and restart your mysql daemon for changes to take effect. If a restart is not an option, the setting can also be applied online, via the mysql command:
# mysql -u root -p -e "set global net_write_timeout=180;"

Keep in mind that this setting will reset to its original value during restart if it is not saved in the configuration file.

  • If you have raised the value to 180 seconds, but backups are still failing with the same error message, try to use a higher timeout value. The timeout can get exceeded, for example, if the tape gets swapped during the MySQL backup. Note that some tape libraries require more than 180 seconds to handle the tapes.

The current active value can be determined as follows:

# mysql -u root -p -e "SHOW GLOBAL VARIABLES LIKE 'net_write_timeout'"
+-------------------+-------+
| Variable_name     | Value |
+-------------------+-------+
| net_write_timeout | 60    |
+-------------------+-------+

Problems during MySQL backup if user's password contains special characters – use configuration file to store the password

Problem

  • There may be problems during backup if the password of the user, assigned for executing the backups, contains special characters. In general, the use of apostrophes as well as mutated vowels (umlauts) is suppressed in the GUI.

Solution

  • Store the password (recommended for all MySQL backups) in a special configuration file rather than a task. If a password is stored separately in the configuration file, it will not appear in SEP sesam logging. See Using Option Files for a complete overview about MySQL configuration files on any supported platform. The following example is suitable for Unix and Linux:
  • Create a configuration file named my.cnf. In case SEP sesam runs as user root and to ensure that the SEP sesam Client can read it correctly, store this file in
/root/.my.cnf
  • Enter the following parameters into the file (the entry user is optional):
[client]
user=root
password=mysqlpw
  • The backup tasks options must include the user name if not set:
-a user=username

The password will now be read from the configuration file during the backup.

Shell login of user root is permitted (i.e., on Ubuntu systems), but the variable $HOME does not exist

Problem

  • If the variable $HOME does not exist, then the file my.cnf cannot be found.

Solution

  • Edit the file <sesam-root>/var/ini/sm.ini and add the following lines at the bottom of the file:
[ENVIRONMENT]
HOME=/root

Once you added the required variable, restart SEP sesam service for changes to take effect.


BSR Pro for Windows

BSR Pro error codes

When performing a BSR Pro backup or restore, the procedure might fail due to different reasons. The following list may be of help to understand the BSR Pro error codes.

  • e0040002: There is a BSR Pro backup or restore currently running; simultaneous operation of more than one BSR Pro backup or restore process is not supported.

BSR Pro installation stops with a message: A new version was found. An update is not necessary.

Problem

  • BSR Pro installation fails with a message, such as: A new version was found. An update is not necessary. This happens when the installation procedure has found another installed version of the BSR Pro (or the original program DiskImage from O&O).

Possible cause

  • In the past, the BSR Pro or O&O DiskImage was already installed manually.

Solution

  • If you want to keep the currently installed version, you have to perform the SEP sesam installation without the BSR Pro. Otherwise the currently installed BSR Pro version has to be uninstalled and then the SEP sesam installation together with BSR Pro has to be performed again.

BSR Pro fails to update during silent SEP sesam update

Problem

  • BSR Pro is not updated when you update a SEP sesam Server, RDS or Client component including BSR in silent mode, e.g. via the powershell command line:
sesam-cli-5.1.0.3-windows.x64.exe -Wait -Verb runAs -ArgumentList '/s',/v"/quiet /lvoicewarmup \"C:\tmp\sm_msi_update.lgc\""

Cause

  • BSR Pro is installed with own MSI installer and cannot be included automatically in a chained installation. During a manual update using the installer EXE, or during the remote update installation via the SEP sesam GUI (sm_update_client) BSR Pro will be updated normally. During the silent installation the update of BSR Pro is not performed.

Solution

To update the BSR Pro you can perform one of the following:

  • Use the regular GUI-based update which also includes the updated version of BSR Pro.
  • Use the SEP sesam GUI (sm_update_client) update which also includes BSR update.

BSR Pro backup fails due to snapshot backup issue

Problem

  • BSR Pro backup fails with BSR Pro unknown return code (0X1).

Cause

  • On some Windows OS (e.g., Windows Server 2012) you may receive a "volsnap" error in the Windows Event log: Event ID 25: The shadow copies of volume C: were deleted because the shadow copy storage could not grow in time. Consider reducing the IO load on the system or choose a shadow copy storage volume that is not being shadow copied.

This error indicates that the source drive is experiencing a high IO load, which caused VSS to fail and deleted the shadow copy snapshot, as a result causing a BSR Pro backup failure.

Solution

  • You have to reduce the IO load on the drive being backed up or configure VSS to use a different drive with more available space (and less load) and ensure that there is sufficient storage space to create and maintain shadow copies. You may want to allocate a separate volume on a separate disk for storing shadow copies, as recommended by Microsoft, to improve performance and eliminate the possibility to delete the shadow copies due to a high I/O load.

For details, see Volume Shadow Copy Volsnap Event 25. See also the following Microsoft article: Event ID 25 — Diff Area Integrity

No savesets nor clients exist in SEP sesam after clicking Execute BSR Pro Quick-Start option

Problem

  • The list of available save sets at the SEP sesam Server remains empty.

Possible cause

This error typically occurs when the connection to the SEP sesam Server cannot be established due to any of the following:

  1. Problem with name resolution: SEP sesam Server hostname is not known to client, name to IP or IP to name (reverse) resolution is not correct.
  2. The client's name (typically a new host is set up in case of disaster recovery with new IP) cannot be resolved at the SEP sesam Server.
  3. Wrong server name (a fully qualified domain name (FQDN) may be required).
  4. When booting from PE, it may take a little longer until the savesets appear (30-45 seconds).

Solution

  1. Check your name resolution on client and SEP sesam Server. Both names must be resolved, the client IP must be resolved to the client name, and SEP sesam Server must be reachable (check the route to it – FQDN may be required to reach it). For reference, see How to check DNS configuration. If the resolution in your network does not work as expected, there might be issues with IPv6 and IPv4.
  2. Add the client's name to the name resolver or add it to the /etc/hosts on SEP sesam Server, or use the GLBV gv_stpd_auth NONE to disable the IP name to IP address check on SEP sesam Server; in the latter case, open a shell on the SEP sesam Server and execute the command below. This command enables you to contact the SEP sesam Server even if the reverse name resolution does not work on the new client.
  3.  sm_glbv w gv_stpd_auth NONE
  4. Specify the SEP sesam Server with the FQDN. Open the BSR Pro Settings -> tab Security and in the Authentication table check the settings. Under the Network path/server, a valid sesam:{server} name or interface must be specified.
  5. Examples:
     ''Network path/server''                      ''Port''
     sesam:http://sep_server.mydomain.com   11000
     sesam:sep_server2                        11001
    Information sign.png Note
    Only the first entry is used to fill the list of available savesets!

OODIAG crashes during the creation of the BootISO

Problem

  • If you try to create a boot ISO with the BSR Pro on a system where the volumes are dynamic volumes, then the OODIAG service cored under certain circumstances.

Possible cause

  • Problem is apparently the system volume. Possibly it is related to the dynamic volume.

Solution

  • Install a newer SEP sesam version with BSR Pro.
  • If possible, do not use dynamic volumes.

VSS snapshot for the system volume does not work

Problem

  • Typically, VSS is used by default to log changes in data so that unchanged data is included in the backup. But on some systems the VSS snapshot for the system volume does not work.

Solution

  • Start SEP sesam BSR Pro with the option -a snap=snapshot. This option creates a special snapshot that does not involve the Microsoft VSS Writer: data changes are logged using the installed filter driver to include the unchanged data in the backup.
Usage: -a snap=vss|snapshot
where <vss> is default

It is not possible to get the error-log for a failed restore in a PE

Problem

  • Disk full while accessing X: because dump is written to it.

Possible cause

  • The LOG is getting too big because it is constantly being written on.

Solution

  • Open the registry in the command shell by using regedit.
  • Add the following reg-key:
[HKEY_LOCAL_MACHINE\SOFTWARE\O&O\O&O DiskImage\<version>]
"DumpFilePath"="E:\\DUMPS\\"
  • After the change the LOG is written to the path E:\DUMPS.

SEP sesam uninstallation of the BSR Pro component fails

Problem

  • Uninstallation of the BSR Pro component fails and leaves invalid registry entries behind.

Solution

  • After a failed uninstallation, the uninstaller information is probably corrupted and you have to get rid of any potentially harmful registry leftovers to ensure normal operation of SEP sesam. There are two possible ways to deal with failed uninstallation leftovers.
  1. The best way to uninstall these components is to use the installer; you should first reinstall BSR Pro in order to repair it, and only then uninstall it again.
  2. SEP Tip.png Tip
    After a successful and complete uninstall of the BSR Pro component, the keys listed below (see registry entries) should no longer exist. If any of the listed keys is still present, it can be deleted manually as described in the next procedure.
  3. If the procedure above cannot be successfully applied, you have to manually remove the BSR Pro installation.
  4. Information sign.png Note
    The following steps describe how to modify the registry. If you modify the registry incorrectly, serious problems might occur. If you are not sure about what you are doing, we recommend that you contact SEP support at support@sep.de for assistance.
    1. In the Start menu/Search box, type regedit and click Enter. The Windows Registry Editor window opens.
    2. Delete the registry entries:
    3.  HKEY_LOCAL_MACHINE\SOFTWARE\O&O\O&O DiskImage
       HKEY_LOCAL_MACHINE\SOFTWARE\O&O\O&O LiveUpdate\SEP sesam BSR Pro

BSR Pro backup fails with a connection error

Problem

  • BSR Pro backup may fail with one of the following errors due to blocked network connection to SEP sesam Server:
script processing failed:

or

(Status: ERROR 425 Can't open data connection. WINSOCK: Connection timed out. (0x274c,10060)

or

Port negotiation failed. (10038)

Possible cause

  • Windows Firewall is preventing or blocking your connections.

Solution

  • Check the Windows Firewall rules on the SEP sesam Client with BSR Pro. If the firewall rule applied during SEP sesam installation is no longer valid, create an exception for oodiag.exe to allow connection through the firewall. For details on how to configure this firewall rule, check the Prerequisites in the SEP sesam BSR Pro – Backup Configuration.


NDMP

NDMP connection error during backup

Problem

  • The NDMP server fails to connect to SEP sesam (sbc_ndmp) during an NDMP backup. Errors like the following are displayed and the backup fails.
NDMP error:  ERR NDMP4_DATA_CONNECT  NDMP4_CONNECT_ERR
NDMP error:  ERR NDMP4_DATA_ABORT  NDMP4_ILLEGAL_STATE_ERR

or

NDMP error: NDMP_DATA_CONNECT 

Possible causes

  • In most cases, this is a firewall problem.
  • Other incorrect network settings prevent the connection to sbc_ndmp.
  • In the case of NetApp, multiple interfaces may prevent the connection to sbc_ndmp.

Solution

  • Exclude sbc_ndmp.exe from the firewall scanner and run the backup again.
  • Check the configuration of your network. Note that your network must be configured correctly to allow the connection to sbc_ndmp.
  • In the case of NetApp, if multiple interfaces are suspected, set the preferred interface option on your NAS device to specify the interface which should be used for NDMP:
options ndmpd
options ndmpd.preferred_interface <interface_name>

For more details, see NetApp-specific NDMP configuration.

NDMP restore to new restore target with non-existent subdirectory fails

Problem

  • An NDMP restore to a new restore target where the intended restore target is a different, non-existent subdirectory fails. (In previous SEP sesam versions, the NDMP alternate restore to a non-existent subdirectory fails, but it is shown as successful. Although this is now fixed, you may want to verify that the previously restored NDMP data exists.)

Note that this is only the case if the new restore target is a non-existent subdirectory. For example, if you want to restore to a /<volume_name>/<sub_dir1>/<sub_dir2> and <sub_dir1> does not exist, the restore will fail. You can still restore NDMP to the alternative target subdirectories if they already exist.

Cause

  • If a subdirectory is specified as the new (non-existing) restore target, for example, /<volume_name>/<sub_dir1>/<sub_dir2>, the restore fails as non-existing subdirectories are not supported when restoring to another target. In this case, only a single level directory structure can be used as the restore target: /<volume_name>/<target_dir>; so in the above example, the supported restore target path is /<volume_name>/<sub_dir1>.

Workaround

  • When performing an NDMP restore to a new restore target, make sure that you restore your data to the top-level directory (/<volume_name>/<target_dir>). Do not specify any non-existing subdirectories in the new target path, otherwise the restore will fail.

Selective NDMP restore does not restore empty directories and the restore fails

Problem

  • In SEP sesam versions ≤ 4.4.3 Beefalo V2, when performing a selective NDMP restore, empty directories are not restored (created) on the target if:
    • empty directories are present in the restore list along with normal directories and files (this is a known issue, but too minor to warrant a fix)
    • at least one file is selected in another directory, for example, if the backup source is /vol/vol1 and the restore selection is /vol/vol1/dir_1/file_1 and /vol/vol1/empty_dir

Consequently, the restore fails.

Cause

  • If only directories are selected for selective restore, the empty directories are added to the SEL file by sm_restore and the restore completes without error. However, if at least one file is selected together with an empty directory, the restore fails.

Workaround

  • When performing a selective restore, try not to restore empty directories together with individual files, otherwise the restore will fail.

NDMP on NetApp

NDMP browsing of non-UTF-8 fails and restore to non-UTF-8 volume may not be possible

Problem

  • When performing a restore, it is not possible to browse the contents of non-UTF-8 NetApp volumes. You may receive an error message similar to the following:
NDMP error:  ERR NDMP4_SNAP_DIR_LIST  ?0x20500106?

This can happen because:

  • Non-UTF-8 volumes are not searchable if objects contain umlauts or special characters.
  • Consequently, a restore to a non-UTF-8 volume is not possible if objects with special characters are included in the NDMP backup.

The following ONTAP CLI command displays the encoding language of all volumes:

volume show -vserver * -fields language

Solution

  • NDMP backups of NetApp volumes without UTF-8 encoding language are basically possible, but the path in the backup task can only be specified manually.
  • If a backup of a non-UTF-8 volume contains objects with umlauts or special characters, the restore can only be performed to a UTF-8 volume.

NDMP DAR restore of single files is too slow

Problem

  • When using a Direct Access Recovery (DAR) which enables NDMP selective restore, restore is too slow, even though DAR should greatly reduce the time it takes to restore individual files.

Cause

  • The general prediction is that DAR greatly increases restore speed, but this depends on the amount and size of data backed up. As stated by NetApp, the restore can take quite some time depending on the number of files in the directory, the position of the directory and file on the tape, and the number of tapes to be read. Refer to the NetApp documentation for details.

Solution

  • Split the backup into smaller parts to reduce the amount of information that DAR has to manage during the restore.

Restore fails with: "Storing of nlist entries failed."

Problem

  • Restore finishes with the error message: "Storing of nlist entries failed."

Workaround

  • Instead of commonly used version 4 of the NDMP protocol, start the NDMP daemon in version 3 by entering the following commands:
ndmpd off
ndmpd version 3
ndmpd on
  • Then retry the NDMP restore.


Hyper-V Troubleshooting/en

KVM/QEMU

Merging and deleting leftover snapshots

Problem

  • The backup fails and the snapshot is left behind.

Solution

Use the virsh utility, as shown in the example:

  1. List the available snapshots for the domain:
  2.  user@hypervisor:~$ virsh snapshot-list <domain_name>
     Name                 Creation Time             State
     ------------------------------------------------------------
     Sesam_SF20173828282@XXXX      2017-07-06 08:15:11 +0200 disk-snapshot

    In this example, one leftover snapshot for this VM exists.

  3. List the virtual disks for the domain:
  4.  user@hypervisor:~$ virsh domblklist <domain_name>
     Target     Source
     ------------------------------------------------
     sda        /path/to//Sesam_SF20173828282@XXXX.snapshot
  5. For each device that refers to SEP sesam snapshot, start a block commit to merge the snapshot:
  6.  user@hypervisor:~$ virsh blockcommit <domain_name> sda --active --verbose --pivot
     Block Commit: [100 %]
     Successfully pivoted
  7. Confirm that the device is now switched to the original disk device:
  8.  user@hypervisor:~$ virsh domblklist <domain_name>
     Target     Source
     ------------------------------------------------
     sda        /my/original/base.img
  9. Delete the snapshot metadata information:
  10.  user@hypervisor:~$ virsh snapshot-delete <domain_name> --metadata --snapshotname Sesam_SF20173828282@XXXX
     Domain snapshot sesam_snapshot deleted
  11. Delete the snapshot file:
  12.  user@hypervisor:~$ rm /path/to//Sesam_SF20173828282@XXXX.snapshot


Si3 Deduplication

Unable to establish connection to S3 data store

Problem

Si3 NG data store may be unable to establish secure connection to S3 storage with the following error:

Error: Could not access data store. Server Status: 2023-03-30 10:17:10: ERROR Not started due to error: S3 is not connected Server Status: 2023-03-30 10:17:10: ERROR Not started due to error: S3 is not connected

Cause

In case Si3 NG data store connects to a storage provider that uses a self-signed certificate, this certificate is not recognized as trustworthy by default because it is not issued by a trusted certificate authority. This can result in connection being denied and log files in /var/opt/sesam/var/log/sms may contain a log message similar to this:

[...default-dispatcher-6] [1;31mERROR[0;39m [36mS3[0;39m - Unexpected error: {}, cause: {}
software.amazon.awssdk.core.exception.SdkClientException: Unable to execute HTTP request: javax.net.ssl.SSLHandshakeException: General OpenSslEngine problem

Solution

To solve this problem use the keytool utility to import the public.crt certificate to the server certificate store. This will allow the Si3 server to recognize and trust the S3 storage provider's certificate, and establish a secure connection.

  1. Obtain the public certificate. Note that you can export it from the browser.
  2. Locate the cacerts file on your server. This is the location of your JVM certificate keystore.
  3. Import the public.crt certificate into the JVM's certificate keystore with the following command:
on Linux:
keytool -import -trustcacerts -keystore /var/lib/ca-certificates/java-cacerts -storepass changeit  -noprompt -alias <storage backend endpoint URL> -file /<path_to_certificate>/public.crt
on Windows:
C:\Program Files\ojdkbuild\java-11-openjdk-11.0.15-1\bin>keytool -import -trustcacerts -keystore "C:\Program Files\ojdkbuild\java-11-openjdk-11.0.15-1\lib\security\cacerts" -storepass changeit -noprompt -alias <storage backend endpoint URL> -file <path_to_certificate>\public.crt

Issues with S3 or S3-compatible storage

Problem

  • Si3 NG data store using S3 or S3-compatible storage can experience various issues, depending on cloud storage provider. These issues can affect backups, migrations, and replications. In addition, sanity state check of Si3 NG could report errors that have similar root cause.

Cause

  • Some cloud storage providers (for example, Wasabi) have request rate restrictions (how many HTTP(S) requests are allowed per second). Also on local storage with S3 option enabled, when multiple RDSs access the same local S3 storage, this can generate a lot of IOPS (I/Os per second).

Solution

  • You can adjust the settings on the affected Si3 NG data store:
  1. In the Main selection -> Components, click Data Stores to display the data store contents frame.
  2. Right-click the selected Si3 NG data store and then click Properties.
  3. Double-click a drive to open Drive Properties dialog, and then in Options field enter as follows:
dedup.s3.timeoutInSeconds=1200,dedup.s3.page.workers=2,dedup.maxAsyncRequests=50
This will increase the timeout period, active page workers and request rate.

Si3 remains in "shutting down" state

Problem

  • Manually stopping Garbage Collection (GC) fails and consequently Si3 remains in the "shutting down" state.

Solution

  • Restart the Si3 daemon by using sm_main restart sds. For more details on stopping and starting the SEP sesam services, see How to Start and Stop SEP sesam.

Si3 deduplication may not work with NFSv4

Problem

  • Si3 deduplication may not work with Network File System version 4 (NFSv4).

Cause

  • SEP sesam operations, such as backup, restore and migration, may fail due to Java problems with NFSv4.

Solution

  • To avoid this problem, connect your backup devices via NFSv3.

Repairing corrupted Si3 NG data store

You can repair the Si3 NG store when pages or objects get corrupted.

  1. First determine the scope of corruption:
    • To get the list of corrupted objects use:
      sm_dedup_interface -d <datastore> corruptedobjects
    • To get the list of corrupted pages use:
      sm_dedup_interface -d <datastore> corruptedpages
  2. Use the following command to replace the page in /pages directory with an older version from /pages-trash directory:
    sm_dedup_interface -d <datastore> repair pages
    The pages in trash contain all chunks deleted on previous GC. The oldest version of a page takes priority.
  3. Use the following command to search for and recover the missing chunks in /pages-trash directory:
    sm_dedup_interface -d <datastore> repair start
    During the repair process a new page is created, which contains all chunks from the current page (page affected by 'missing chunks' issue) and all chunks found in the trash.

Cleanup of unrecoverable Si3 NG store

SEP Warning.png Warning
You should use the commands described in this section only in case the corrupted store cannot be recovered.

When corruptions in the Si3 NG store persist, the initial page version has already been purged from trash or there were fatal errors during backup or restore. In this case broken pages or missing chunks cannot be recovered.

Cleanup can be performed by deleting unrecoverable objects manually or by using the automatic cleanup function.

Deleting objects

When there are only a few unrecoverable objects, delete each object with the following commands:

sm_dedup_interface -d <datastore> delete corruted_object_id_1

...

sm_dedup_interface -d <datastore> delete corruted_object_id_Nth

In case of many corruptions you can delete all corrupted objects using the following command:

sm_dedup_interface -d <datastore> fsck purge
Garbage collection

When you have deleted all unrecoverable objects, run garbage collection (gc):

sm_dedup_interface -d <datastore> gc start
Automatic cleanup function

To start an automatic cleanup function, use the following command:

sm_dedup_interface ... fsck purge auto

The automatic cleanup function runs the following sequence of commands: PCCK start -> OCCK start -> Delete all corrupted objects -> GC start.

Logging

The logging function uses a relatively powerful logback library. For more information, see Logback Project. Note that this information is intended for advanced users only.

Logging info
  • gv_rw_ini:sm_sds.xml (/var/opt/sesam/var/ini/sm_sds.xml)
  • /var/opt/sesam/var/log/sms contains two log files:
    • sm_dedup_server_info-<drive>.log: Log level INFO and higher.
    • sm_dedup_server-<drive>.log: Log level DEBUG and higher. This file can become quite large.
    • sm_dedup_gc-<drive>.log: garbage collection log.
    • sm_dedup_fsck-<drive>.log: file system check log.
  • Auto rotation if the log file size reaches 100 MB.

Files and directories

Objects

For every SEP sesam saveset, three objects (files) are stored in the Si3 NG store:

  • <ssid>.data
  • <ssid>.info
  • <ssid>.info2

The .data and .info files are identical to those of a normal data store. The .info2 file is required for the data to be appended to a Si3 object. All database information that is not available before a backup is completed is written to this file.

Directories


Tape and tape devices issues

Problem with tape drives

Problem

There are problems with LTO tape drives which repeatedly request cleaning tape. Additionally, backups fail with I/O errors.

Solution

There are two possible causes for this:

  • SEP sesam has problems communicating properly with tape devices if the hardware vendor's tape diagnostic tools are still installed after the tape read/write diagnostic test is successful. To prevent the tape drives from repeatedly issuing the cleaning request and ensure that backups complete successfully, remove the tape diagnostic tools immediately after completing the diagnostic tests. For example, there are some problems with the different tape drives LTO5 and LTO7. In our example, you will disable or remove the following components:
  1. Disable the HPE Version Control Agent.
  2. Disable all tape agents for HPE Insight Management Agents as shown below.

HPE Insight-disable tape agent.jpg

  1. Uninstall HP Library and Tape Tools (L&TT) from your server using the Add/Remove Program in the Window's Control Panel.
  • Similar issues may be caused by common hardware-related problems. Refer to your hardware vendor documentation for details on hardware configuration and troubleshooting.

Restore fails due to a missing block that was not written to tape, but no error is generated during backup

Problem

(Applies only to Windows SEP sesam Server or RDS, ≤ SEP sesam Beefalo V2) When backing up to tape, a data block is not written to the tape when the segment size is reached at the End of Media (EOM), therefore restoring data referencing this block is not possible. A path archive can still be restored until EOM is reached, but a complete restore or migration fails.

Solution:

  1. Detect whether your tapes are affected by following the procedure How to detect affected savesets below.
  1. Update your Windows SEP sesam Server to a newer version. If your tape device is attached to a Windows RDS, you have to install the update to the respective RDS.

How to detect affected savesets

The following steps must be executed on your SEP sesam Server.

  1. Check the path behind the variable gv_rw_lis in sm.ini to see if your LIS folder's destination was changed. Example with modified LIS folder – set to D:\SEPsesam\var\lis\:
  2.  [PATHES]
     gv_rw_lis=D:\SEPsesam\var\lis\
  3. Open the command prompt ('Windows Command Processor' or Linux 'Terminal') and enter the following commands. Change to the directory of your LIS folder according to sm.ini gv_rw_lis=... :
    • Windows (default): C:\ProgramData\SEPsesam\var\lis
       cd C:\ProgramData\SEPsesam\var\lis
       findstr /R /C:"^.*:.*:0:.*:1$" *.sgm
    • Linux (default): /var/opt/sesam/var/lis
       cd /var/opt/sesam/var/lis
       grep "^.*:.*:0:.*:1$" *.sgm
  4. If the command retrieves some lines, check the related sgm files. In the following example, the third line (marked red) shows an occurrence of a lost block.
     1:140479734912:1088:MP_File_Full00001:38956
     1:143030262144:1089:MP_File_Full00001:48605
     <span style="color:red">1:146212528704:0:MP_File_Full00010:1</span>
     10:146212594176:1:MP_File_Full00010:55536
  5. The third line shows the following: On tape with ID 1: there are 146212528704 bytes written, but then it shows the segment 0 that is not a real segment number but caused by error, ending by :1 block that is actually lost.

Problems with LTO-9 tapes

Error loading new LTO-9 tape

Problem

SEP sesam is unable to load a new LTO-9 tape into a tape drive. When uncalibrated LTO-9 tapes are inserted into a library, they cannot be moved into the drive. During archive adjustment, SEP sesam identifies the slots containing such media and marks them with an orange indicator to signal that tape initialization is required.

Cause

Some tape libraries (for example, HPE MSL2024 up to G3, 1/8 G2 Autoloader, and similar) do not allow loading a non-calibrated LTO-9 tape media into a tape drive. This prevents accidental loading of non-calibrated tapes into the drive and helps prevent possible backup issues while a new LTO-9 tape initialization is in progress.

For more information, see HPE Support Center: LTO-9 Media initialization.

Solution:

For such libraries, use New Media Initialization Wizard to perform the new LTO-9 tape initialization.

Note that the initialization process for a tape can take between 20 minutes and up to 2 hours. In most cases it will complete within 30 minutes for a tape, however, in some cases it may take up to two hours. After start the initialization process cannot be aborted.

Limited or no access to new LTO-9 tapes

Problem

When introducing new LTO-9 tapes, SEP sesam may encounter access issues, time-outs or backup delays because of ongoing LTO-9 tape initialization.

Cause

Some tape libraries (for example, HPE StoreEver MSL6480, and similar) allow moving a non-calibrated LTO-9 tape media into a tape drive, but start the initialization process before the tape can be first used. In this case SEP sesam may encounter issues with backup because of ongoing LTO-9 tape initialization.

Solution:

LTO-9 tapes require one-time media initialization before read/write operations can first be started. In most cases this initialization process will complete within 30 minutes for a tape, however, in some cases it may take up to two hours. Note that after start the initialization process cannot be aborted.

To prevent issues with delayed or failed backups to new LTO-9 tapes, it is recommended to initialize the new LTO-9 tape using archive adjustment with the Automatic introduction option. This starts the media initialization before first use.

It is important that you do not use the option Adjustment by barcode only when running archive adjustment. This option collects barcodes for slots without moving the tape into the drive. Therefore, media initialization is not performed during archive adjustment. Instead, it will start the first time the tape is used.

Alternatively, you can use New Media Initialization Wizard to perform the new LTO-9 tape initialization before using it with SEP sesam.


VSS Troubleshooting/en

HPE StoreOnce Catalyst

HPE StoreOnce backups fail

If your backups fail, one of the reasons could be related to HPE StoreOnce sizing parameters. In this case, check the following:

  • If you have defined a Physical or Logical Storage Quota for your Catalyst store, check if the quota limits have been reached. If so, increase the quota to a sufficient size. For details, see HPE StoreOnce Configuration.
  • If you created an HPE Catalyst data store in SEP sesam and later changed the HPE Catalyst store size parameters, e.g., by changing or removing the storage quotas, check their values in SEP sesam GUI: Main selection -> Components -> Data Stores, double-click your StoreOnce store, and then click the HPE Catalyst Store State tab. If the data store status is set to "failed", you may need to adjust the StoreOnce data store (Size) Capacity and High watermark values to allow for correct calculation and make the data store functional again. For details, see Size and Disk space usage.

HPE StoreOnce backup failed with "553 STOR Failed. Error: Ctl_OpenObject failed, error: OSCLT_ERR_MAXIMUM_SESSIONS. (0)

Problem

  • HPE StoreOnce backup failed with 553 STOR Failed. Error: Ctl_OpenObject failed, error: OSCLT_ERR_MAXIMUM_SESSIONS. This issue can occur when an HPE StoreOnce Catalyst data session fails to open because the maximum number of sessions on the HPE StoreOnce Catalyst server is reached, thus no other session can be started until resources are available. You can check the number of free data sessions in SEP sesam by opening your HPE StoreOnce data store properties and clicking the tab HPE Catalyst Store State, then checking the value of Free data sessions.

Solution

There are two possible solutions:

  • The HPE Catalyst server supports a limited number of concurrent data sessions. Therefore, you need to ensure that the maximum number of data sessions for your HPE StoreOnce is not exceeded, or increase the maximum number of data sessions (including restores) that can be run simultaneously.
  • Open SEP sesam and from the Main selection -> Components -> Data Stores double-click your HPE StoreOnce data store to open the properties. Then, under Drives click the relevant drive to view its properties. In the Max. channels drop-down list, decrease the number of available channels for concurrently running backup/migration streams. By default, the number of available channels is set according to your SEP sesam Server license (e.g., the standard license supports 10 concurrent streams, enabling 10 backup processes to run simultaneously).


Proxmox VE

Proxmox VE backup does not work with the client name as plain IP address

Problem

  • If the node added to the SEP sesam environment is not set up correctly and an IP address is used as the client name instead of the client's hostname matching the hostname returned by the Proxmox server, the backup fails.

Solution

Proxmox VE backup failed with a connection error

Problem

  • Proxmox VE backup failed with Error connecting to proxmox System: "('Connection aborted.', gaierror(-2, 'Name or service not known'))"]. This error occurs after a VM has been migrated to another cluster node. Consequently, the Proxmox VE backup fails.

Solution

  • Ensure that every Proxmox VE cluster node can correctly resolve other cluster nodes using DNS or the Hosts file.

File backup of Proxmox hypervisor fails

Problem

  • Backup of /etc/pve/ fails.

Solution

  • Exclude the /etc/pve/ directory from backup. /etc/pve/ is just a file system representation of the cluster database, which is located under the path /var/lib/pve-cluster/config.db. For more information, see the Proxmox wiki article. For more information, see also Proxmox Cluster File System (pmxcfs).


See also

Error Messages Guide