Skip to main content

 

Druva Documentation

Phoenix agent logs and configuration details

Phoenix Editions: File:/tick.png Business File:/cross.png Enterprise File:/tick.png Elite

This article provides information about the Phoenix agent configuration details and log files for a SQL server setup.

Phoenix agent log files

The Phoenix agent log files contain details of backups that the Phoenix agent performs. After every backup, a new log file is created in the Phoenix<YYYY/MM/DD>-<timestamp>.log format. If Phoenix agent does not function as expected, you can share these log files with the Druva Support team.

Note: Phoenix retains logs for the last 32 agent activities on each server. 

On all versions and editions of SQL server, you can find the logs at: C:\ProgramData\Phoenix\logs. The free space at this location should be at least 1% of your source data size. 

Note: After each backup and restore, Phoenix performs a rollover of the accompanying logs. If you encounter an error during a backup or restore, check the log file for errors at the time of the backup or restore operation. 

Additional logs

In addition to the Phoenix logs, you can also find the following logs on your SQL servers:

  • Windows Event Viewer logs are created with a .evt location. To know how to manage these logs, see this article in the Microsoft library. If you encounter errors during backup or restore, look for errors with source = ‘VSS’, ‘MSSQLSERVER’, or ‘SQLVDI’.
  • The SQL server logs. To know more, read this article describing the SQL server logs

Phoenix agent configuration details

The Phoenix.cfg file contains the configuration details that Phoenix agents require to communicate with Phoenix Master. 

Note: We recommend that you do not modify Phoenix.cfg except when required. In scenarios where you must modify these configuration files, contact the Druva Support team for assistance. 

You can find the Phoenix agent configuration details at the following locations:

  • Windows 2012 Server
    C:\ProgramData\Phoenix
  • Windows 2008 Server
    C:\ProgramData\Phoenix
  • Windows 2003 Server
    C:\Documents and Settings\All Users\Application Data\Phoenix

Phoenix agent services

On Windows servers, Phoenix Agent Client Service manages backups and restores. The PhoenixCPH service on Windows servers ensures that the Phoenix Agent Client Service is running. 

Note: If Phoenix agent stops working, PhoenixCPH (Windows) starts Phoenix agent. 

Phoenix agent metadata

When you install Phoenix agents on your servers, the following metadata folders are created in the Phoenix folder:

  • The restorestate folder
    This folder contains metadata that optimizes restores. 
  • The <agentid> folder
    This folder contains metadata that optimizes backups. 

Note: The string <agentid> represents the type of Phoenix agent. The name 1 represents file server agents, and the name 10 represents SQL server agents respectively. 

On SQL servers, the metadata folders are created at C:\ProgramData\Phoenix

Additional metadata

At the time of restore, Phoenix creates a database_files.txt file at <Drive>\restore\<snapshot>\<Request ID>. This file contains details of how the database files are mapped to the database, and how the database is mapped to its instance in a Unicode format. You require this file to manually attach the database to an instance at the time of restoring to a different server.