Eramba_v3 Migration Procedure

This step-by-step guide explains how to migrate eramba from version e2.20.7 to e3.x (if you have not upgraded to e2.20.7 please review this post). There is a video at the end of this guide for further assistance.

YOU WILL REQUIRE ACCESS TO YOUR LINUX SYSTEM AND SOME LINUX SKILLS SO PLEASE CONTACT YOUR SYSTEM ADMINISTRATORS FOR HELP!

  1. Email support@eramba.org a request that you want to upgrade to eramba_v3 the following information:
  • System / About (Screenshot showing app id, app version and database version)

  • System / Settings / System Health (Screenshot showing all items are OK)

    In return you will receive a download link for the upgrade package. Once you receive this link you can then continue (NOT BEFORE)

  1. Comment your crontab so you prevent them from running during migration
  2. Make backup of files and database or simply create snapshot of the machine
  3. Create app_local file under /eramba_v2/app/Config/ (download sample from here)
  4. Confirm eramba is running in offline mode by going to System / Settings / Updates (a message will be shown to you making this very explicit)
  5. Download the upgrade package e3.0.0
  6. Navigate into eramba_v2/app and run command
    Console/cake update update /FullPathToPackageE3.0.0
  7. Download upgrade package 3.0.1
  8. Navigate into eramba_v2/app/upgrade and run command
    bin/cake update --from-package=/FullPathToPackageE3.0.1
  9. Repeat the steps 8 and 9 until you with version e3.0.6
  10. At this point you can login into eramba using the web-interface as usual, just make sure you login with admin user or a user that is member of the admin group and then go to System / Settings / System Health and make sure all is OK (green). If you find NOT OK (red) messages then you need to go one by one and correct whatever is necessary:

Typical issues:

Permissions: you need to make sure all files inside eramba are owned by a user/group that apache is running. In ubuntu, for example: chown www-data: eramba_v2 -R (important the -R to make it recursive)

Database Permissions: you need to make sure the user that connects to your database has the right permissions. Login to your engine as root and make sure the user is granted all the following rights: GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER,INDEX,TRIGGER ON database_name. TO ‘mysql_user’@‘localhost’;*

  1. Update crontab with new commands
  2. Go to System / Settings / Help Improve eramba and enable improvement mode (it send us additional logs so we are able to debug and diagnose the problem faster if some issue occurs)
  3. Go to System / Settings / Updates and update any outstanding updates

If at any point in the process, you have an issue (quite unlikely) please extract error logs from (eramba_v2/app/upgrade/logs/) or if you have access to the gui (System / Settings / Error Log / Download All Files) and then contact support@eramba.org and we’ll try to assist (include error logs please)

The video with the instructions:

1 Like

Is there going to be any training, documentation, or a video that walks us through the changes to the tabs and fields, once upgraded?

Hello!
This migration was mostly done in the backend, there is not many changes in user interface.

Hi - The names of some of the tabs and fields have changed and certain items that were default “off” are now on by default. Such as “local account” on the Create User page. It was default off, now it is default on. The “liabilities” field on the Asset page is now “Legal”.

Please if you have more like this write them to support@eramba.org , so we can correct small things like this.