Migrations

Django handles the migration of the database very well; however, there are various changes to SEED that may require some custom (manual) migrations. The migration documenation includes the required changes based on deployment and development for each release.

Version 2.5.1

• The migrations should work by simply running ./manage.py migrate. There are no manual migrations needed for the 2.5.1 release.

Version 2.5.0

Docker-based Deployment

• Add the MapQuest API key to your organization.

• On deployment, the error below is indicative that you need to install the extensions in the postgres database. Run docker exec <posgres_container_id> update-postgis.sh.

  django.db.utils.OperationalError: could not open extension control file “/usr/share/postgresql/11/extension/postgis.control”: No such file or directory

• If you are using a copied version of the docker-compose.yml file (e.g., for OEP support), then you need to change 127.0.0.1:5000/postgres to 127.0.0.1:5000/postgres-seed

Development

• Delete your bower directory rm -rf seed/static/vendors.
• Delete your css directory rm -rf seed/static/seed/css.
• Remove these lines from local_untracked.py if you have them.

DEFAULT_FILE_STORAGE = 'django.core.files.storage.FileSystemStorage'
STATICFILES_STORAGE = DEFAULT_FILE_STORAGE

• Run pip3 install -r requirements/local.txt.
• Run npm install from root checkout of SEED.
• If testing geocoding, then sign up for as a MapQuest Developer and create a new MapQuest Key.
• Add the key to the organization that you are using in development.
• Update your DATABASES engine to be django.contrib.gis.db.backends.postgis

DATABASES = {
    'default': {
        'ENGINE': 'django.contrib.gis.db.backends.postgis',
        'NAME': 'seeddb',
        'USER': 'seeduser',
        'PASSWORD': 'seedpass',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

• Run ./manage.py migrate