TracError: The Trac Environment needs to be upgraded.

[hornetbzz@…]

Summary:
Getting TracError in the browser: The Trac Environment needs to be upgraded.

Description:
Changing trac.ini [notification] section using SFTP, restarting Apache, I got this TracError: The Trac Environment needs to be upgraded. returned by the browser. Reverting back to the previous trac.ini file, same error.

How To Reproduce:

• connect ssh as root to your remote machine
• edit (SFTP) /usr/share/trac/project/my_project/conf/trac.ini
• apply any minor change that you are sure they are correct
• save the modified file
• restart your server (in case of apache2: /etc/init.d/apache2 restart)
• connect your trac host in your browser: ​http://www.mydomain/

then you get this error.

[hornetbzz@…]

SOLVED:
This error has nothing to do with TRAC. Modifying the trac.ini file using SFTP as root, the file trac.ini owner has been thus changed from your Apache user (www-data or nobody or guest or what ever you use) to "root".

So resetting the trac.ini ownership to the apache user solved this "issue" :

example here for a Linux machine

APACHE_USER="www-data"
APACHE_GROUP=$APACHE_USER
chown $APACHE_USER:$APACHE_GROUP /usr/share/trac/project/my_project/conf/trac.ini