Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

Users with special needs, i.e. very large sites, upgrading from pre 1.2 Roller, customized data models, can choose not use auto-install. By setting installation.type=manual they can choose to do upgrades the old way, running scripts by hand.

To These are the steps to install Roller with auto-install these are the steps:

STEP 0 - Prerequisites: Java 5, Roller supported database, Servlet 2.4 container and JDBC driver jar in Servlet container's classpath.

...

STEP 3 - Deploy roller.war to your Servlet container and browse to context URI. If there is a database connection error, you'll see details in the browser. If tables need creation or upgrade, Roller will do it automatically for you on your commantcommand.

Here are the specific changes to be made to enable property based installation/configuration:

...

This logic is executed ONLY if auto-install is enabled.

  • If DB connection fails
    • If installation.auto, show error page to explain what went wrong and how to fix it
    • Else, show simple error/maintenance page
  • If DB does not have tables
    • If installation.auto, show table creation page/action
    • Else, show simple error/maintenance page
  • forward to DatabaseError action
  • Else if Roller tables not found direct to CreateDatabase action
  • Else if Roller tables need upgrade direct to UpgradeDatabase actionIf DB is older version
  • If installation.auto, show database upgrade page/action
  • Run database upgrade scripts and do upgradeDatabaseIfNeeded logic
  • Else, show simple error/maintenance page

Change #6: Database creation/upgrade infrastructure - READY TO COMMIT

...