How to Upgrade to Version 11 (or Higher)

Introduction

Upgrading from Easy8 version 10 to version 11 or higher brings significant improvements but also technical changes. This guide helps server administrators prepare for and perform a safe and successful upgrade. Cloud users can relax—our team takes care of everything for you.

Target Audience

Administrator

Prerequisites

Before you begin, ensure:

You are running version 10.14.x LTS
Your system is Debian 10 or 11
Your database is Percona/MySQL 5.7+
Redis is installed (version 5+)
Node.js 14.16+ is installed
Your current Ruby version is 2.6.7 or higher
You have full access and backups of your environment

For ease, consider requesting a preconfigured Easy VM from our support team.

How to Upgrade to Version 11 or Higher

Step 0: Update to Latest LTS (10.14.x)

Upgrade your current system to the latest 10.14.x version before proceeding.

Step 1: Upgrade Ruby

rvm install ruby 2.6.7 --patch railsexpress
rvm use ruby-2.6.7 --default
rvm remove ruby-2.5.3
gem install bundler
gem list | grep bundler

Make sure bundler version is 2.2.16 or higher.

Step 2: Install Node.js

sudo apt update
sudo apt upgrade
curl -sL https://deb.nodesource.com/setup_14.x | sudo bash -
sudo apt install nodejs
node -v

Confirm version is v14.16.0 or higher.

Step 3: Download the Upgrade Package

Download the version 11+ package from the Client Zone and copy it to your server.

Step 4: Stop the Application

sudo systemctl stop puma@your.domain.name

Step 5: Choose Upgrade Method

a) Automatic Upgrade (Recommended)

redmine upgrade name_of_package

Follow the steps in the wizard.

b) Manual Upgrade

mv current/ current_old/
mkdir current
cd current/
unzip /path/to/package.zip
bundle install
bundle exec rake easyproject:install RAILS_ENV=production
sudo systemctl start puma@your.domain.name

Component Upgrade Summary

Operating System

Only Debian 10 (Buster) and Debian 11 (Bullseye) are supported.

Database

Percona/MySQL 5.7+ is required. Refer to upgrade or migration instructions depending on your current database (MySQL, MariaDB, or PostgreSQL).

Ruby and Bundler

Install Ruby 2.6.7+ and ensure bundler is at least version 2.2.16.

Redis and Sidekiq

Used for background jobs. Redis 5+ is required. Configure as follows:

# config/additional_environment.rb

if Rails.env.production?
  config.active_job.queue_adapter = :sidekiq
  redis_url = "redis://127.0.0.1:6379/1"
  Sidekiq.configure_server { |config| config.redis = { url: redis_url, namespace: "easy" } }
  Sidekiq.configure_client { |config| config.redis = { url: redis_url, namespace: "easy" } }
end

Node.js

Must be version 14.16 or higher. Install via NodeSource.

WebSockets and HTTPS

Enable Action Cable and ensure HTTPS is used. Version 11 blocks non-HTTPS URLs.

No More Sub-URI

Sub-URI configuration (e.g., /redmine) is no longer supported. Use a full domain/subdomain instead.

After Upgrade: Format Migration (Textile/Markdown → HTML)

If you were using Textile or Markdown, convert formatted text to HTML:

bundle exec rails easy:convert_wiki_formatting source_formatting=textile

Valid values for source_formatting= are:

textile (default)
markdown
common_mark

Fields affected include:

Issue descriptions
Comments and notes
Wiki content
Project and contact descriptions

Conclusion

Upgrading to version 11 or higher of Easy8 brings modern architecture and essential enhancements. Carefully review and prepare your environment before starting. If unsure, request an Easy VM or assistance from our support team.