Management Utility Invocation

  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

Management Utility Invocation

Basic Invocation

The commandline management utility is invoked using the ccmanage utility:

/usr/local/centovacast/bin/ccmanage

Running ccmanage without parameters will provide a list of the most comment options available. See the detailed command reference for a complete list of available commands.

Passwordless Mode

For automation purposes it may be convenient to skip the password prompt presented by ccmanage when invoked as root. This capability is provided by the sumanage utility:

/usr/local/centovacast/sbin/sumanage

The sumanage utility is identical to ccmanage with the exceptions that it can only be invoked by root, and that it operates without prompting for a password.

For security reasons, sumanage will not operate until you create a special password file with which it can authenticate against Centova Cast's user database. To create the file, you can run the following commands as root:

echo 'admin|adminpassword' > /usr/local/centovacast/etc/.ccshadow
chmod 0600 /usr/local/centovacast/etc/.ccshadow

In the first command above, replace adminpassword with your actual Centova Cast administrator password. You will need to re-execute the above command every time you change your Centova Cast administrator password.

Previous: Centova Cast Management Utility
Section: Centova Cast Management Utility
Next: Output Formats