Update Utility

  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

Update Utility

Centova Cast includes a fully automated update utility to upgrade Centova Cast when a full update or new components are available.

Basic Invocation

The basic invocation for the update utility is:

/usr/local/centovacast/sbin/update

This performs a complete update, and is documented in the Upgrading Version 3 section of the Installation Manual.

Updating Individual Components

If for some reason you only want to update some particular component of Centova Cast instead of performing a complete upgrade, you can pass an application identifier as the first parameter to the update script. For example:

/usr/local/centovacast/sbin/update web

The above would update the Centova Cast web server only. If you need a list of all available, upgradeable application identifiers on your server, you can use this command:

for f in /usr/local/centovacast/etc/update.d/*.update; do
    . $f; echo "${DATADIR/cc-/} - $TITLE"
done

Forcing an Update

Centova Cast automatically detects whether a newer version of each package is available, and will not attempt to update the package if a newer version is not available.

If you wish to force an update (for example, if you suspect the files from the package have been corrupted on your server), you may pass the --force parameter to force the installation, eg:

/usr/local/centovacast/sbin/update --force

This can also be used with individual components as explained in the previous section.

Adding New Components

The update utility can also be used to install new packages into Centova Cast, using the --add parameter.

This is documented in detail in the Adding Additional Software section of the Installation Manual.

Performing Custom Actions on Update

You may wish to have Centova Cast run a custom script before or after an update, for example to preserve and restore modifications you've made to the Centova Cast theme.

Before performing an update, Centova Cast checks for the existence of a preupdate shell script in:

/usr/local/centovacast/sbin/preupdate

If it exists and is executable, Centova Cast will invoke it prior to performing the update.

Similarly, after performing an update, Centova Cast checks for the existence of a postupdate shell script in:

/usr/local/centovacast/sbin/postupdate

If it exists and is executable, Centova Cast will invoke it after the update.

Both preupdate and postupdate are standard shell scripts; they should begin with a shebang line (eg: #!/bin/bash or similar) and may be written in any language for which an interpreter is installed on your server.

The following simple example would preserve any modifications you've made to your Centova Cast logo on the login page:

preupdate:

##!/bin/sh
mkdir -p /usr/local/centovacast/var/preupdate_backup
cp -f /usr/local/centovacast/web/theme/images/login-logo.png \
    /usr/local/centovacast/var/preupdate_backup/

postupdate:

##!/bin/sh
cp -f /usr/local/centovacast/var/preupdate_backup/login-logo.png \
    /usr/local/centovacast/web/theme/images/
rm -rf /usr/local/centovacast/var/preupdate_backup
Previous: Uninstalling Centova Cast
Section: Command-line Tools
Next: Customizations