3. Upgrade¶
3.1. Upgrade 2.0 to 2.1¶
This procedure covers how to upgrade your existing 2.0 OpenEats2 site to version 2.1
3.1.1. Install¶
- Download the latest package from github
- Unzip the file
- Backup your database
- Backup your current site files
- From the unzip file, copy everything other then the settings.py, site-media/upload and site-media/uploads file into your current openeats directory, over writing what is already there
3.1.2. Config File Changes¶
Some minor changes need to be made to the settings.py file of your current site.
Remove the following from the installed apps section of the settings.py file
- admin_tools.theming
- admin_tools.menu
- admin_tools.menu
Add the following to the installed apps section of the settings.py file on the first line:
'grappelli.dashboard',
Add the following to the installed apps section of the settings.py file:
'django.contrib.staticfiles',
Remove the following from the context processors section of the settings.py file:
"grappelli.context_processors.admin_template_path",
Add the following to the context processors section of the settings.py file:
"openeats.context_processors.oetitle",
Add the following line to the settings.py file:
LOCALE_PATHS = (
os.path.join(BASE_PATH, 'locale',)
)
Remove the following lines in your settings.py file:
ADMIN_TOOLS_INDEX_DASHBOARD = 'openeats.dashboard.CustomIndexDashboard'
ADMIN_TOOLS_APP_INDEX_DASHBOARD = 'openeats.dashboard.CustomAppIndexDashboard'
Add the following line to your settings.py file:
GRAPPELLI_INDEX_DASHBOARD = 'openeats.dashboard.CustomIndexDashboard'
Add the following lines to your settings.py file:
STATIC_ROOT = os.path.join(BASE_PATH, 'static-files')
STATIC_URL = '/static-files/'
Change the ADMIN_MEDIA_PREFIX setting in the settings.py file to this:
ADMIN_MEDIA_PREFIX = STATIC_URL + "grappelli/"
Add the following line under the OpenEats Settings section of the settings.py file:
OETITLE="OpenEats2"
You can set this to anything you want your site title to be, it doesn’t have to be set to OpenEats2
Remove the following line from urls.py:
url(r'^admin_tools/', include('admin_tools.urls')),
3.1.3. Removing directories¶
The following directories are no longer needed for version 2.1 and can be removed
- grappelli
- site-media/admin
- site-media/admin_tools
3.1.4. Upgrade third party apps¶
To upgrade all the packages that OpenEats2 requires perform the following steps.
Activate your virtualenv
Change to the directory that you unzipped the OpenEats2 files into
Run the following command:
pip install -r OE2_Requirements.txt --upgrade
3.1.5. Database changes¶
Run the following command from the OpenEats2 directory:
./manage.py syncdb
./manage.py migrate djangoratings 0001 --fake
./manage.py migrate djangoratings 0002 --fake
./manage.py migrate djangoratings 0003
./manage.py migrate djangoratings 0004 --fake
./manage.py migrate djangoratings 0005 --fake
./manage.py migrate djangoratings
./manage.py migrate sentry 0001 --fake
./manage.py migrate sentry 0002 --fake
./manage.py migrate sentry 0003 --fake
./manage.py migrate sentry 0004 --fake
./manage.py migrate sentry 0005 --fake
./manage.py migrate sentry 0006 --fake
./manage.py migrate sentry 0007 --fake
./manage.py migrate sentry 0008 --fake
./manage.py migrate sentry 0009 --fake
./manage.py migrate sentry
./manage.py migrate
3.1.6. Third Party static files¶
Django 1.3 offers a new feature that pulls in all the css and image files from third party apps into one folder. This does away with having to setup symlinks to them yourself. The files are stored in the static-files directory. To get the initial files set run the following command:
./manage.py collectstatic
3.1.7. Rebuild Search Index¶
The search engine was updated as part of this release so it is a good idea to run the following command to rebuild it:
./manage.py rebuild_index
3.1.8. Running¶
After the upgrade you can run the following command to start the internal Django webserver. This will allow you to test your site:
./manage.py runserver 8000
3.2. Upgrade 2.1 to 2.2¶
This procedure covers how to upgrade your existing 2.1 OpenEats2 site to version 2.2. If you are upgrading from 2.0 to 2.2 you will need to follow the steps from Config File Changes down in the Upgrading from 2.0 to 2.1 section.
3.2.1. Install¶
- Download the latest package from github
- Unzip the file
- Backup your database
- Backup your current site files
- From the unzip file, copy everything other then the settings.py, site-media/upload and site-media/uploads file into your current openeats directory, over writing what is already there
3.2.2. Database changes¶
Run the following command from the OpenEats2 directory:
./manage.py migrate list
3.2.3. Running¶
After the upgrade you can run the following command to start the internal Django webserver. This will allow you to test your site:
./manage.py runserver 8000
3.3. Upgrade 2.2 to 2.3¶
This procedure covers how to upgrade your existing 2.2 OpenEats2 site to version 2.3. If you are upgrading from 2.0 to 2.3 you will need to follow the steps from Config File Changes down in the Upgrading from 2.0 to 2.1 section.
3.3.1. Install¶
- Download the latest package from github
- Unzip the file
- Backup your database
- Backup your current site files
- From the unzip file, copy everything other then the settings.py, site-media/upload and site-media/uploads file into your current openeats directory, over writing what is already there
3.3.2. Settings Changes¶
Add the following to your settings.py file under the TEMPLATE_CONTEXT_PROCESSORS area:
'django.core.context_processors.static',
Remove the following from the installed_apps section of the settings.py file:
'reversion',
3.3.3. Upgrade third party apps¶
To upgrade all the packages that OpenEats2 requires perform the following steps.
Activate your virtualenv
Change to the directory that you unzipped the OpenEats2 files into
Run the following command:
pip install -r OE2_Requirements.txt --upgrade
3.3.4. Database changes¶
Run the following command from the OpenEats2 directory:
./manage.py migrate
3.3.5. Update Static Files¶
To update the static files from the third party applications run the following command:
./manage.py collectstatic
3.3.6. Running¶
After the upgrade you can run the following command to start the internal Django webserver. This will allow you to test your site:
./manage.py runserver 8000
3.4. Upgrade 2.3 to 2.4¶
This procedure covers how to upgrade your existing 2.3 OpenEats2 site to version 2.4. If you are upgrading from 2.0 to 2.4 you will need to follow the steps from Config File Changes down in the Upgrading from 2.0 to 2.1 section.
3.4.1. Install¶
- Download the latest package from github
- Unzip the file
- Backup your database
- Backup your current site files
- From the unzip file, copy everything other then the settings.py, site-media/upload and site-media/uploads file into your current openeats directory, over writing what is already there
3.4.2. Settings Changes¶
Remove the following from the installed_apps section of the settings.py file:
'django_generic_flatblocks',
3.4.3. Upgrade third party apps¶
To upgrade all the packages that OpenEats2 requires perform the following steps.
Activate your virtualenv
Change to the directory that you unzipped the OpenEats2 files into
Run the following command:
pip install -r OE2_Requirements.txt --upgrade
3.4.4. Database changes¶
Run the following command from the OpenEats2 directory:
./manage.py migrate
3.4.5. Update Static Files¶
To update the static files from the third party applications run the following command:
./manage.py collectstatic
3.4.6. Update Recipe Picture cache¶
The size of the recipe pictures has changed to re-create the current pictures to the new size run:
./manage.py ikflush recipe
3.4.7. Running¶
After the upgrade you can run the following command to start the internal Django webserver. This will allow you to test your site:
./manage.py runserver 8000