Introduction
This reference lists useful commands for Easy8 server administrators. These commands help in common application and server management tasks. While it does not cover all Linux environments, it provides general guidance. For system-specific details, adapt the commands accordingly.
We welcome tips and experience from your environment—contact support to share insights. Verified and approved tips may be added here.
Target Audience
- Administrator
Server Command Reference
| Situation | Command | Result | Notes |
|---|---|---|---|
| Application didn't start |
sudo service puma restart sudo service nginx restart sudo service easy restart systemctl restart puma@APPLICATION_NAME.service |
Restarts application services | Depends on VM version (old, new, legacy) |
| Migrations are missing |
bundle exec rake db:migrate redmine:plugins:migrate RAILS_ENV=production bundle exec rake easyproject:install RAILS_ENV=production |
Runs migrations for Redmine and plugins | Run install after migrations |
| Uninstall Easy plugin | bundle exec rake easyproject:uninstall:all_plugins RAILS_ENV=production | Uninstalls Easy plugins | For plugins in /plugins/easyproject/easy_plugins |
| Uninstall Redmine plugin | bundle exec rake redmine:plugins:migrate NAME=plugin_name VERSION=0 | Uninstalls specific plugin | For plugins in /plugins |
| Update Ruby dependencies | bundle update | Updates Ruby gems | Use with caution |
| Restart server | reboot | Restarts physical server | |
| Restart database | systemctl restart mysql systemctl restart postgresql |
Restarts DB server | |
| Monitor production log | tail -f [redmine root]/log/production.log | Live log monitoring | Useful for tracing errors |
| Rails console |
rails c rails c -e production RAILS_ENV=production rails c |
Opens Rails console | Test Ruby commands |
| Fix server permissions |
sudo chown -R [user]:[group] [redmine root] chown easy:easy -R $(eval echo "~easy") sudo chmod -R 775 [redmine root] |
Fixes ownership and permissions | Use correct user and folder path |
| Custom SQL in Rails |
rails c production ActiveRecord::Base.connection.execute("UPDATE ...") exit |
Executes custom SQL | Be careful—may break app |
| Custom SQL in MySQL |
mysql -u user -p use database; update issues set ... |
Executes SQL in MySQL | Use with caution |
| Database backup/restore |
mysqldump ... > dump.sql bundle exec rake db:drop db:create RAILS_ENV=production mysql ... < dump.sql |
Full DB backup and restore | For MySQL environments |
| Fix broken project tree |
rails c production Project.rebuild_tree! exit |
Rebuilds project tree structure | Use after DB migrations |
| Check DB config | cat [redmine root]/config/database.yml | Shows DB connection config | |
| Check email config | cat [redmine root]/config/configuration.yml | Shows email settings | |
| Configure cron | crontab -e | Opens crontab | Schedule auto tasks |
| Recalculate resource data | bundle exec rake easy_gantt_resources:reallocate_resources RAILS_ENV=production | Updates resource allocations | Run after plugin install/migration |
| Check system state | top | Shows system activity | |
| Check disk space | df | Displays disk usage | |
| Update Easy DMS cache | ruby [redmine root]/plugins/redmine_dmsf/extra/xapian_indexer.rb | Rebuilds document search index | Only for DMSF users |
| Migrate textile to HTML | bundle exec rake easyproject:textile:migrate_all RAILS_ENV=production | Converts formatting | |
| Activate and recalculate currency |
bundle exec rake easyproject:currency_update_tables RAILS_ENV=production bundle exec rake easyproject:currency_recalculate_all RAILS_ENV=production |
Updates and applies currency | Restart server after update |
| Recalculate time entry costs | bundle exec rake easyproject:easy_money:recalculate_time_entry_expenses_on_project RAILS_ENV=production | Recalculates personnel costs | May take time, applies to all projects |
| Convert SQLite to MySQL | sqlite3 SQLITE3_FILE .dump | python sqlite3-to-mysql.py | mysql -u root -p sqlite3_convert | Converts DB format | See detailed guide before use |
| Manage API limits (legacy) |
Set variables in: /etc/systemd/system/puma@.service /etc/systemd/system/sidekiq@.service |
Set request limits | Restart services afterwards |
| Manage API limits (Docker) | As explained in /docker/README | Set limits via environment variables | Version-specific |
Usage Notes
- All commands assume appropriate permissions and correct environment.
- Double-check before applying commands that modify data.
- When in doubt, consult support or test in a staging environment first.
