LogoLogo
SourceSupportTraining
v6.x
v6.x
  • Introduction
    • Contributing Guide
    • Release History
      • 6.1.0
      • 6.0.5
      • 6.0.4
      • 6.0.3
      • 6.0.0
      • Upgrading From v5.x
    • About This Book
      • Author
  • Getting Started
    • Installation
      • System Requirements
      • *CommandBox Installation
      • Source Installation
      • Existing ColdBox Application
      • Docker
    • Updates
  • Usage
    • Using ContentBox
      • The ContentBox Dashboard
        • Home
        • About
      • Content
        • Publish Content
          • Blog
          • Sitemap
          • Content Editing Tips
            • Editor Features
            • Dynamic Variable Output
            • Markdown Support
            • Relocations
            • Scheduled Content
        • Custom Content
          • Content Store
          • Content Templates
          • Categories
          • Media Manager
          • Menu Manager
      • Comments
        • Inbox
        • Settings
      • Look & Feel
        • Active Theme
        • Global HTML
        • Themes
        • Widgets
          • Inserting a Simple Widget
      • Media Manager
      • Modules
        • Installing Modules
        • Managing Modules
      • Users
        • Manage
        • Permissions
        • Roles
      • Tools
        • Import
        • Export
        • Static Site Generation
      • System
        • Auth Logs
        • Geek Settings
        • Settings
          • Site Options
          • Admin Options
          • Security Options
          • Login Options
          • Content Options
          • Editor Options
          • Media Manager Options
          • Gravatars
          • Notifications
          • Mail Server
          • Search Options
          • Login Options
        • Security Rules
        • Updates
      • Widgets
        • An Easy Example
        • Inside the Page Editor
    • Developing For ContentBox
  • Front End Development
    • Front End Development
      • File Structure
      • JS and CSS Assets
      • Customizing Views
      • Customizing Layouts
      • Customizing Navigation
      • Global Variables
      • Managing Assets
      • Template Variables
      • The Content Store
    • Theme Development
      • Theme Settings
      • Theme UDFs
      • Theme Templates
      • Theme Layouts
      • Theme Views
      • Theme SEO Functionality
  • Back End Development
    • Back End Development
      • Overriding ContentBox Settings
      • Modules
        • Installing a Module
        • Using a Module
        • Module Locations and Conventions
        • Build a Module
        • Scaffold a Module
        • Theme your Module
        • Build an Admin Module
        • Adding Admin Menus to your Module
        • Adding Meta to your Modules
      • Widgets
        • Core Widgets
        • Simple Widget
        • Widgets with Arguments
        • Multiple Render Function Widgets
      • Interceptors
      • Accessing Logged in User
      • Customizing the Admin
      • Staying on the Upgrade Path
Powered by GitBook
On this page
  • 1. Requirements
  • Upgrade System Dependencies
  • 2. Backups
  • 3. MySQL UTF8mb4
  • 4. Run the Updater
  • *nix/Mac
  • Windows
  • 5. Final Steps
  • Optional Steps

Was this helpful?

Edit on GitHub
Export as PDF
  1. Introduction
  2. Release History

Upgrading From v5.x

Last updated 1 year ago

Was this helpful?

ContentBox v6.x is a major version update and will require the following instructions to update your v5.x installations. Please follow this guide or contact us at so we can assist you during your upgrade process.

If you are in version 4.x then you will need to upgrade to version 5.x before upgrading to the 6.x series

1. Requirements

All Upgrades to ContentBox should be done with the assistance of So ensure you have CommandBox installed on the server/machine you will be upgrading.

Upgrade System Dependencies

Once you have CommandBox installed, let's make sure we have some global dependencies installed so CommandBox can work with ContentBox automated upgrades:

# install env controls and db migrations
box install commandbox-dotenv,commandbox-migrations --force

This will install the module and the module that will be used to provide upgrades in the future. This is only done once. ContentBox 5 already ships with these dependencies once you install it.

2. Backups

Please make sure you backup your source code and your database. We are not liable for broken installations.

Make sure the database, the tables and columns are using utf8mb4 if you are using MySQLx

3. MySQL UTF8mb4

If you are using MySQL you will need to make sure your database and your tables are all using the following character set: utf8mb4 and NOT just utf8. ContentBox 5 requires the charset to be utf8mb4.

We also suggest you use the utf8mb4_general_ci collation for your database, tables and columns as well.

4. Run the Updater

We have prepared a CommandBox task to upgrade your installation in one easy execution. This will upgrade your files and run the database migrations for you.

*nix/Mac

If you are in a Linux or Mac environment, you can execute the task using the following shell commands from the root directory of your application.

# Download the updater
curl -o Updater.cfc https://raw.githubusercontent.com/Ortus-Solutions/ContentBox/master/build/patches/6.0.0/Updater.cfc
# Execute the task
box task run Updater.cfc
# Clean it up
rm Updater.cfc

Windows

If you are in Windows, download the following task:

and place it at the root of your project. Then, issue the following CommandBox shell command to execute it.

# Run the task
box task run Updater.cfc
# Clean it up
rm Updater.cfc

5. Final Steps

The updater will update your installation and run the migration scripts. However, it will also override the following files:

Application.cfc
readme.md
config/CacheBox.cfc
config/Coldbox.cfc

It will create .bak files for the originals so you can manually merge in any changes you had before.

Once you do, go ahead and start up the engines! You are upgraded!

Optional Steps

If you have developed themes, modules, models, or any type of extension based on ContentBox 5, you will most likely have to update your code to match the new interfaces, methods, and approaches. Especially since ContentBox 6 runs on ColdBox 7.

info@ortussolutions.com
CommandBox CLI.
environment
database migrations
https://raw.githubusercontent.com/Ortus-Solutions/ContentBox/master/build/patches/6.0.0/Updater.cfc