Skip to main content

Logging & Traces

Backint Settings will log all the information related with a backup or restore execution in its own log file.

Topics


Backint logs

You can find Backint logs to help you troubleshoot errors and failures in the following locations:

FilePathDescription
Local log/var/log/emory/SID.logStores all information related with the Backint execution and the backup/retore process. (SAP HANA backup/restore process will be stored in the global log)
Global log (HANA only)/usr/sap/SID/SYS/global/hdb/opt/log/emory.logStores all information about the backup/restore execution in a single or multihost environment

Set up logging options

You can configure the following parameters for your log lifecycle:

ParameterDescription
Log Rotation PeriodSpecify the number of days after which a log file will be saved in a new file and the main log will be emptied
Log File Max AgeSpecify the number of day after which the log files will be deleted from the system
Configuration File

You can find these values in the configuration file emory.cfg.


_10
Logging:
_10
max_age: 30
_10
rotation_time: 1

You can set the logging options by:

  • Executing the following as SAP Database Administrator user:


    _10
    /opt/emory/emory logging <retention_in_days> <rotation_in_days>

OR

  • Using the interactive menu by following these guidelines:

    1. Start emory-settings tool by executing /opt/emory/emory as SAP Database Administrator user.

    2. Select Logging file settings from Main Menu to initiate the license specific setup.


      _18
      ? Backint: [Use arrows to move, enter to select, type to filter]
      _18
      --------------------------------------------------------------------------------
      _18
      Storage Providers profiles
      _18
      Set storage providers for backup/restore, disaster recovery and system copy
      _18
      Backups Lifecycle settings
      _18
      Monitoring
      _18
      --------------------------------------------------------------------------------
      _18
      License
      _18
      --------------------------------------------------------------------------------
      _18
      > Logging file settings
      _18
      Debug traces
      _18
      Show relevant information of this Backint
      _18
      --------------------------------------------------------------------------------
      _18
      Catalog & Backups management
      _18
      --------------------------------------------------------------------------------
      _18
      Generate troubleshooting package to be sent to Syntax Support
      _18
      --------------------------------------------------------------------------------
      _18
      Exit

    3. Specify the Log File Max Age.


      _10
      ? Backint: Logging file settings
      _10
      ? Sets the max age in days of a log file before it gets purged from the file system: (0)

    4. Specify the Log Rotation Period:


      _10
      ? Backint: Logging file settings
      _10
      ? Sets the max age in days of a log file before it gets purged from the file system: 1
      _10
      ? Sets the time, in days, between rotation: (0)

    5. You can now select Return and Exit to save the configuration if no other action should be taken.

Debug and traces

In case of an issue with Backint, you can activate the Trace level for emory logging. This will give you a more detailed information on what is happening during a backup or restore execution in the Backint side. This information is stored in the standard emory.log file.

danger

Backint traces, when active, can increase considerably the Backint log file. Ensure that you always deactivate them after an incident or performance resolution.

In case of an issue with Backint, you can activate the Trace level for emory logging. This will give you a more detailed information on what is happening during a

Enable debug traces

Execute the following command as SAP Database Administrator user to activate the traces:


_10
/opt/emory/emory debug true

You can also perform this action through the interactive menu by executing /opt/emory/emory as SAP Database Administrator user and selection the Debug Traces section.

Disable debug traces

Execute the following command as SAP Database Administrator user to disable debug traces:


_10
/opt/emory/emory debug false

You can also perform this action through the interactive menu by executing /opt/emory/emory as SAP Database Administrator user and selection the Debug Traces section.

Generate a troubleshooting package

You can generate automatically a troubleshooting package to be sent to us if required.

You can do that by:

  • Executing the following as SAP Database Administrator user:


    _10
    /opt/emory/emory troubleshooting

OR

  • Using the interactive menu by following these guidelines:

    1. Start emory-settings tool by executing /opt/emory/emory as SAP Database Administrator user.

    2. Select Generate troubleshooting package to be sent to Syntax Support from Main Menu to generate the package.


      _18
      ? Backint: [Use arrows to move, enter to select, type to filter]
      _18
      --------------------------------------------------------------------------------
      _18
      Storage Providers profiles
      _18
      Set storage providers for backup/restore, disaster recovery and system copy
      _18
      Backups Lifecycle settings
      _18
      Monitoring
      _18
      --------------------------------------------------------------------------------
      _18
      License
      _18
      --------------------------------------------------------------------------------
      _18
      Logging file settings
      _18
      Debug traces
      _18
      Show relevant information of this Backint
      _18
      --------------------------------------------------------------------------------
      _18
      Catalog & Backups management
      _18
      --------------------------------------------------------------------------------
      _18
      > Generate troubleshooting package to be sent to Syntax Support
      _18
      --------------------------------------------------------------------------------
      _18
      Exit

In both cases, you will find a .zip file in the same directory where you executed the command.