How to Update Ruby Version

Introduction

Ruby is the core programming language required to run Easy8. As Easy8 evolves, new versions may require updated Ruby versions to work correctly. This guide will help you safely upgrade Ruby on your server while avoiding common pitfalls.

TIP: Switch to Docker to never worry about Ruby versions again.

Target Audience

• Administrator

Prerequisites

Before proceeding, make sure:

• You are using a supported Linux environment
• You have rvm (Ruby Version Manager) installed
• You can access the application server with root or sudo privileges
• You have created a backup of your application and data

Always check the current supported Ruby version in the Software Requirements before upgrading.

How to Update Ruby Version

Step 0: Create a Full Backup

Before making any changes:

• Backup your Easy8 files and database
• Backup your server configuration files
• Snapshot your virtual machine if applicable

Step 1: Install the New Ruby Version

sudo rvm get head
sudo rvm install ruby-3.3.4-railsexpress
rvm use --default ruby-3.3.4-railsexpress

Make sure you install the Ruby version that matches your Easy8 requirements.

Step 2: Install Bundler

gem install bundler

Step 3: Update Gems

cd APPLICATION_ROOT
bundle update

This will reinstall all required gems for the new Ruby version.

Step 4: Reinstall Easy8

rake easyproject:install RAILS_ENV=production

Step 5: Update Ruby Version in Startup Configuration

You may need to adjust system service files to reflect the new Ruby version or point to the default version.

Example paths to check:

/etc/systemd/system/sidekiq@appname.service.requires/puma@appname.service
/etc/systemd/system/easy.service

Example service configuration block:

[Service]
Type=simple
User=easy
WorkingDirectory=/srv/easyredmine/public_html
Environment=RAILS_ENV=production
PIDFile=/srv/easyredmine/run/application.pid
ExecStart=/bin/bash -lc 'bundle exec puma -C /home/easy/puma.rb -e production'

Make sure this service starts Ruby with the correct version or with the --default switch.

Troubleshooting

If the application does not start:

• Check the error logs:
  • puma.err (Puma error log)
  • production.log (Application log)
• Contact Easy Software support with these logs if needed

Conclusion

Updating Ruby is required to run the latest versions of Easy8, but it must be done carefully. Follow each step, verify compatibility, and make sure all services are correctly pointing to the new Ruby version. When in doubt, reach out to our support team or consider migrating to Docker for a worry-free experience.

Related Topics and Further Reading

• Easy8 Documentation
• RVM (Ruby Version Manager)
• RubyGems Official Site