Django-South useful commands.

django-south

Normal Migration
1. The developer (you) change the models.py file, updating the application's data model.
2. Run manage.py schemamigration app_name --auto to create a migration file for generation N+1.
3. Run manage.py migrate app_name to update the database schema and migrationhistory table to generation N+1.

Initial Migration
1. The developer (you) creates the first models.py file, defining the  application's data model.
2. Run manage.py schemamigrate app_name --initial to create a migration  file for generation 1.
3. Run manage.py migrate app_name to create the database schema and  migrationhistory table to generation 1.

Converting an Application

On the first app instance
1. Run manage.py convert_to_south app_name to create the migration file for generation 1, and also to create the migrationhistory entry.

On other app instance
1. Run manage.py migrate app_name 0001 --fake to create the migrationhistory without changing the database schema.

Other useful commands
1. manage.py migrate --list