> For the complete documentation index, see [llms.txt](https://docs.storware.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.storware.eu/troubleshooting/how-switch-vprotect-to-debug-mode.md).

# Enable DEBUG mode in Storware Backup and Recovery

## Available log levels

<table><thead><tr><th width="134">LEVEL</th><th width="614">DESCRIPTION</th></tr></thead><tbody><tr><td>INFO</td><td>Provides general operational messages to confirm that the software is functioning as expected</td></tr><tr><td>DEBUG</td><td>Offers detailed diagnostic information to help developers troubleshoot issues</td></tr><tr><td>TRACE</td><td>Provides the most granular level of detail, often used to trace the execution of specific code paths</td></tr></tbody></table>

## Changing log level in the Storware Backup and Recovery components

### Server

1. Connect to the server host using SSH
2. Open the following file for editing\
   `/opt/vprotect/server/quarkus.properties`\
   \
   Example:

   ```
   vi /opt/vprotect/server/quarkus.properties
   ```
3. Locate the line in the file that controls the logging mode\
   `quarkus.log.category."eu.storware".level=INFO`\
   \
   The default value for the logging level is INFO
4. Set the value to INFO, DEBUG or TRACE
5. Save the file
6. Restart the service:

   ```
   systemctl restart vprotect-server
   ```

### Node

1. Connect to the node host using SSH
2. Open the following file for editing\
   `/opt/vprotect/node/log4j2-node.xml`\
   \
   Example:

   ```
   vi /opt/vprotect/node/log4j2-node.xml
   ```
3. Locate the line in the file that controls the logging mode\
   `<Property name="logLevel">INFO</Property>`\
   \
   The default value for the logging level is INFO
4. Set the value to INFO, DEBUG or TRACE
5. Save the file
6. Restart the service:

   ```
   systemctl restart vprotect-node
   ```

### Tape manager

1. Connect to the tape manager host using SSH
2. Open the following file for editing\
   `/opt/vprotect/tapemanager/config/application.properties`\
   \
   Example:

   ```
   vi /opt/vprotect/tapemanager/config/application.properties
   ```
3. Locate the line in the file that controls the logging mode\
   `quarkus.log.level=INFO`\
   \
   The default value for the logging level is INFO
4. Set the value to INFO, DEBUG or TRACE
5. Save the file
6. Restart the service:

   ```
   systemctl restart vprotect-server
   ```

### OS agent

1. Connect to the client host
2. Open the following file for editing\
   \
   Windows system:\
   `C:\ProgramData\sbr-osagent\osagent.properties`\
   \
   Linux system:\
   `/opt/vprotect/osagent`\
   \
   MacOS system:\
   `/Library/Application Support/osagent`
3. Locate the line in the file that controls the logging mode\
   `osagent.logs.level=INFO`\
   \
   The default value for the logging level is INFO
4. Set the value to INFO, DEBUG or TRACE
5. Save the file
6. Restart the service:<br>

   Windows

   ```
   sc stop sbr-osagent && sc start sbr-osagent
   ```

   Linux

   ```
   systemctl restart sbr-osagent
   ```

   \
   MacOS

   ```
   sudo launchctl stop eu.storware.sbr.osagent
   sudo launchctl start eu.storware.sbr.osagent
   ```
7. Connect to the tape manager host using SSH
8. Open the following file for editing\
   `/opt/vprotect/tapemanager/config/application.properties`\
   \
   Example:

   ```
   vi /opt/vprotect/osserver/config/application.properties
   ```
9. Locate the line in the file that controls the logging mode\
   `quarkus.log.level=INFO`\
   \
   The default value for the logging level is INFO
10. Set the value to INFO, DEBUG or TRACE
11. Save the file
12. Restart the node service:

    ```
    systemctl restart vprotect-node
    ```
