Diagnostic Report Generator

  1. API Reference
    1. API Types
    2. Class Types
    3. JSON API
    4. XML API
    5. Session API
    6. JSON and XML APIs - Asynchronous API Responses
    7. Server Class Method Reference {#apiserverclass}
    8. System Class Method Reference {#apisystemclass}
  2. System Accounts
  3. Advanced Configurations
    1. Dual v3/v2 Deployment
    2. Using centovacast.conf
  4. Command-line Tools
    1. Controlling Centova Cast
    2. Diagnostic Report Generator
    3. Fixing Problems
    4. Centova Cast Management Utility
      1. Management Utility Invocation
      2. Output Formats
    5. Reinstalling Centova Cast
    6. Uninstalling Centova Cast
    7. Update Utility
  5. Customizations
    1. Init Script
    2. Menu Customizations
    3. Wrapping Server Applications
  6. Event Scripts
    1. Event Script Reference
    2. Event Notification Scripts
    3. Event Script Structure
  7. Files and Paths
    1. Account Files and Paths
    2. Core Files and Paths
    3. Formats
      1. nextsong.log File Format
  8. Plugins
    1. Event Script Reference
    2. Example Plugin
    3. Plugins API
    4. Plugin Structure

Diagnostic Report Generator

To assist in troubleshooting Centova Cast-related problems, Centova Cast includes a utility which can create a detailed report about your system for review by an administrator or the Centova Technologies staff. Providing such a report to the helpdesk can greatly reduce the time required to diagnose a problem with your server.

There are three ways to invoke the report script:

  • /usr/local/centovacast/sbin/generatereport
    With no parameters, this script generates a brief report about your overall system status/integrity.

  • /usr/local/centovacast/sbin/generatereport full
    With the 'full' parameter, this script generates an overall system report, plus includes your core Centova Cast configuration files, Centova Cast master log files, and information about the integrity of your Centova Cast application files and database tables, all of which are invaluable for diagnosing system issues.

    All highly-sensitive information (such as your crypto key) is omitted from the report for your security.

  • /usr/local/centovacast/sbin/generatereport user1 [user2 user3 ...]
    When one or more usernames are specified as parameters, this script generates an overall system report, plus detailed information about each of the specified user accounts, including their complete account settings, server/auto DJ configuration files, and log files.

    Highly-sensitive information (such as passwords) is omitted from the report to the best of the script's ability, but the report file should still be kept confidential as it may still contain enough information to be of use to an attacker.

Previous: Controlling Centova Cast
Section: Command-line Tools
Next: Fixing Problems