NAME

krang_upgrade - upgrade Krang from a dist file

SYNOPSIS

  # bin/krang_upgrade

DESCRIPTION

This script will upgrade Krang on a RedHat 7.3 (i686-linux) system from a dist file created by krang_makedist.

What krang_upgrade does

Following is a list of the tasks the upgrade script will perform.

• Check pre-requisites

  • Validate path to KRANG_ROOT.

  • Ensure KRANG_ROOT isnt set before invoking bin/krang_upgrade

  • Locate and parse existing krang.conf file.

  • Verify that Krang has been shut down.

• Make a backup of the existing Krang system using 'krang_backup'.

• Install new Krang system over the existing files in KRANG_ROOT with the following exceptions:

  • lib/Krang.pm which holds the Krang version number.
  • conf/ssl.crt/server.crt and conf/ssl.key/server.key files are not overwritten if they curent exist, to prevent loosing existing SSL certificates.

• Apply upgrade scripts.

• Copy lib/Krang.pm into place, updating Krang's version number.

• Update db_version for each instance

• Clear out sessions from database.

• Start Krang

• Output results of upgrade to console.

OPTIONS

 --KrangRoot         - Directory where Krang is installed, defaults to 
                       /usr/local/krang.

 --MySQLRootPassword - Password for the MySQL user "root".  Defaults to
                       "".

 --MySQLHost         - Host that MySQL server is running on. Defaults to
                       "" - which connects to the local host.

 --no-backup         - Skip making a backup before running the upgrade.

 --no-start          - Skip starting the Krang services after the upgrade

 --no-chown          - Skip re-chowning all of the files to the KrangUser
                       and KrangGroup. This is useful if you have a lot of
                       data files and you know that nothing has changed the
                       ownership of the files

 --no-db             - Skip any database related changes for the upgrade. This
                       is mainly used if you have multiple machines running Krang
                       which share a common database.

 --help              - Show usage

 --man               - Show full man page

SEE ALSO

Refer to docs/ops_upgrade.pod.