2011-11-07, 17:16
Okay, I've just pushed some pretty hefty changes to the master branch. It's the in-app-config stuff that I mentioned previously.
If you're already using Maraschino and wish to use this new version then it's going to require a few changes, and you're going to lose any customisation that you've already entered. Bigger picture though - it'll be worth it
I've updated maraschinoproject.com with new instructions, but I've written some instructions (below) for people who are upgrading from the old version.
First, do a "git pull" to update your copy of the repository.
Next, install the new dependency - "easy_install Flask-SQLAlchemy"
Now delete your settings.py file. That's right, delete it!
Copy the new settings_example.py over to settings.py and open it in your editor. You'll notice that there is now only one setting: DATABASE. Make it point to where you would like the database file saved, e.g.:
Make sure that the web server has write access to this directory.
Now, run the setup file (this example assumes that you're in the Maraschino directory):
If you see "Database successfully initialised" then you're good to go. If you get an error then running this command as a superuser (e.g. "sudo python setup.py") might help.
htpcfrontend.py has been renamed to maraschino.py, so you're going to need to update your WSGI file to look something like this:
If you're using Apache, make sure that www-data is the owner of the directory/files:
Finally, restart Apache and open Maraschino in your browser.
If things looks weird then clear your browser's cache and reload the page as the CSS has changed quite a bit.
It should be fairly self-explanatory how to add, remove, configure and organise modules, but I'm here if you have any questions.
Also, there may be bugs. They're an inevitable part of an early-stage project like this. Please let me know if you find any and I'll do what I can to fix them!
If you're already using Maraschino and wish to use this new version then it's going to require a few changes, and you're going to lose any customisation that you've already entered. Bigger picture though - it'll be worth it
I've updated maraschinoproject.com with new instructions, but I've written some instructions (below) for people who are upgrading from the old version.
First, do a "git pull" to update your copy of the repository.
Next, install the new dependency - "easy_install Flask-SQLAlchemy"
Now delete your settings.py file. That's right, delete it!
Copy the new settings_example.py over to settings.py and open it in your editor. You'll notice that there is now only one setting: DATABASE. Make it point to where you would like the database file saved, e.g.:
Code:
DATABASE = '/var/www/maraschino/maraschino.db'Make sure that the web server has write access to this directory.
Now, run the setup file (this example assumes that you're in the Maraschino directory):
Code:
python setup.pyIf you see "Database successfully initialised" then you're good to go. If you get an error then running this command as a superuser (e.g. "sudo python setup.py") might help.
htpcfrontend.py has been renamed to maraschino.py, so you're going to need to update your WSGI file to look something like this:
Code:
import sys
sys.path.insert(0, "/var/www/maraschino")
from maraschino import app as applicationIf you're using Apache, make sure that www-data is the owner of the directory/files:
Code:
cd /var/www
sudo chown www-data:www-data maraschino -RFinally, restart Apache and open Maraschino in your browser.
If things looks weird then clear your browser's cache and reload the page as the CSS has changed quite a bit.
It should be fairly self-explanatory how to add, remove, configure and organise modules, but I'm here if you have any questions.
Also, there may be bugs. They're an inevitable part of an early-stage project like this. Please let me know if you find any and I'll do what I can to fix them!
