Devilry sysadmin docs

• Getting started
  • Install required system packages
  • Create a system user for Devilry
  • Make a directory for your Devilry deploy
  • Make a requirements file for Python packages
  • Install from the requirements file
  • Create a Django management script
  • Configure
  • Create or migrate a database
  • Collect static files
  • Run the gunicorn server
  • If you do not have an existing database — Add some data
  • If you have an existing database
  • Stop the gunicorn server
  • Whats next?
• Setup a Devilry authentication backend
  • Choices
  • The default authentication backend
  • Authenticate using LDAP
  • Autoset email
• Setup Redis with RQ for background task processing
  • Install Redis
  • Configure Redis
  • Add RQ setup for Redis Devilry
  • Run RQ workers
  • Verifying the setup
  • Advanced setup
• Sending emails in background task
• Setup Supervisord for process management, log handling and log rotation
  • Create a Supervisord configuration file
  • Password and security
  • Create the var/ and log/ directories
  • Make sure all services work as excpected
  • Run Supervisord for production
  • Init script
• Setup Nginx, Apache or some other web proxy server with SSL
  • Nginx config example
• How to configure error tracking with Sentry
  • Settings
  • Settings (legacy)
  • Whats next?
• How to configure logging for Devilry
  • Gunicorn logging
  • Configuring Logrotate for Gunicorn and Nginx
• Debug problems
• Update Devilry
• Autoset email from the authentication backend username
• Devilry Managment Commands
  • devilry_nodeadd
  • devilry_subjectadd
  • devilry_permissiongroup_add_subject
  • devilry_subjectadminadd
  • devilry_subjectadminclear
  • devilry_subjectsearch
  • devilry_periodadd
  • devilry_periodadminadd
  • devilry_periodadminclear
  • devilry_periodsearch
  • devilry_periodsetrelatedexaminers
  • devilry_periodsetrelatedstudents
  • devilry_resave_all_users
  • devilry_sync_candidates
  • devilry_useradd
  • devilry_useraddbulk
  • devilry_usermod
  • devilry_usersearch
  • devilry_delete_periods
  • devilry_delete_inactive_users
  • devilry_resend_failed_messages
  • devilry_delete_message_receivers
  • devilry_delete_messages_without_receivers
  • devilry_anonymize_database
• How to setup Dataporten (Feide etc.) login
  • Settings
  • Setup the dataporten application
  • Add required data to the database
  • Use username instead of feide ID
• Branding devilry
  • Simple branding with templates
  • Available template variables
  • Advanced branding
• Django settings for Devilry
  • DEVILRY_IMPORTED_PERIOD_TAG_DEFAULT_PREFIX
  • DEVILRY_SKIP_RQ_TESTS
  • DEVILRY_RQ_EMAIL_BACKEND_QUEUENAME
  • DEVILRY_DEFAULT_EMAIL_USERNAME_SUFFIX
  • DEVILRY_ASSIGNMENT_GUIDELINES
  • DEVILRY_LACKING_PERMISSIONS_URL
  • DEVILRY_WRONG_USERINFO_URL
  • DEVILRY_OFFICIAL_HELP_URL
  • DEVILRY_ORGANIZATION_SPECIFIC_DOCUMENTATION_URL
  • DEVILRY_ORGANIZATION_SPECIFIC_DOCUMENTATION_TEXT
  • DEVILRY_DOCUMENTATION_VERSION
  • DEVILRY_FRONTPAGE_HEADER_INCLUDE_TEMPLATE
  • DEVILRY_FRONTPAGE_FOOTER_INCLUDE_TEMPLATE
  • DEVILRY_HELP_PAGE_HEADER_INCLUDE_TEMPLATE
  • DEVILRY_HELP_PAGE_FOOTER_INCLUDE_TEMPLATE
  • DEVILRY_PROFILEPAGE_HEADER_INCLUDE_TEMPLATE
  • DEVILRY_PROFILEPAGE_FOOTER_INCLUDE_TEMPLATE
  • DEVILRY_ENABLE_REALTIME_ZIPFILE_CREATION
  • DEVILRY_JAVASCRIPT_LOCALE_OVERRIDE_APPS
  • DEVILRY_ASSIGNMENT_PUBLISHING_TIME_DELAY_MINUTES
  • DEVILRY_RESTRICT_NUMBER_OF_FILES_PER_DIRECTORY
  • DEVILRY_FEIDE_USERID_SEC_TO_USERNAME_SUFFIX
  • DEVILRY_BRANDING_FAV_ICON_PATH
  • DEVILRY_MEMORY_DEBUG_ENABLED
  • DEVILRY_HARD_DEADLINE_INFO_FOR_STUDENTS
  • DEVILRY_HARD_DEADLINE_INFO_FOR_EXAMINERS_AND_ADMINS
  • DEVILRY_COMMENT_STUDENTS_CAN_EDIT
  • DEVILRY_COMMENT_STUDENTS_CAN_SEE_OTHER_USERS_COMMENT_HISTORY
  • DELIVERY_STORAGE_BACKEND
  • DELIVERY_TEMPORARY_STORAGE_BACKEND
  • CRADMIN_LEGACY_TEMPORARY_FILE_STORAGE_BACKEND
  • DEVILRY_COMPRESSED_ARCHIVES_DIRECTORY
  • STORAGES
• Compressed archives for filedownload
  • Setup environment variable
  • Deleting compressed archives
  • Recommendations
  • What if I mess up with deletion?
• Editable UI messages
  • Hard deadline information text in delivery feed
• Devilry message framework
  • The status of a message receiver
  • Configuring the resend limit
  • Deleting old receivers
  • Deleting messages without message receivers
  • Managing message receivers via Djangoadmin

Importing data from Devilry v2

Dump data from Devilry v2 and import to Devilry v3.

• Migrate data from Devilry v2 to Devilry v3
  • Dumping the Devilry v2 data
    • Backup/copy files
  • Importing the Devilry v2 data to Devilry v3
  • Additional info about the import script
  • Remove old semesters

Migration guides

If a minor version is not listed here, it is a code-only update, which means that the update guide is all you need.

• Migrating from 1.X.X to 2.0.0
• Migrating from 3.0.0 to 3.0.1
• Migrating from 3.0.0beta to 3.0.0
• Migrating from 3.0.[0-2] to 3.0.3
• Migrating from 3.0.3 to 3.1.0
• Migrating from 3.1.0 to 3.1.1
• Migrating from 3.1.1 to 3.1.2
• Migrating from 3.1.2 to 3.1.3
• Migrating from 3.1.3 to 3.1.4
• Migrating from 3.1.4 to 3.1.5
• Migrating from 3.1.4 or 3.1.5 to 3.1.6
• Migrating from 3.1.6 to 3.2.0
• Migrating from 3.2.0 to 3.3.0b1
• Migrating from 3.3.0 to 3.3.1
• Migrating from 3.3.0b1 to 3.3.0b2
• Migrating from 3.3.0b10 to 3.3.0b11
• Migrating from 3.3.0b11 to 3.3.0
• Migrating from 3.3.0b2 to 3.3.0b3
• Migrating from 3.3.0b3 to 3.3.0b4
• Migrating from 3.3.0b4 to 3.3.0b5
• Migrating from 3.3.0b5 to 3.3.0b6
• Migrating from 3.3.0b6 to 3.3.0b7
• Migrating from 3.3.0b7 to 3.3.0b8
• Migrating from 3.3.0b8 to 3.3.0b9
• Migrating from 3.3.0b9 to 3.3.0b10
• Migrating from 3.3.1 to 3.3.2
• Migrating from 3.3.2 to 3.3.3
• Migrating from 3.3.3 to 3.4.0
• Migrating from 3.4.0 to 3.4.1
• Migrating from 3.4.1 to 3.4.2
• Migrating from 3.4.2 to 3.4.3
• Migrating from 3.4.3 to 3.4.4
• Migrating from 3.4.4 to 3.4.5
• Migrating from 3.4.5 to 3.4.6
• Migrating from 3.4.6 to 3.5.0
• Migrating from 3.5.0 to 3.5.1
• Migrating from 3.5.1 to 3.5.2
• Migrating from 3.5.2 to 3.6.0
• Migrating from 3.6.0 to 3.7.0
• Migrating from 3.7.0 to 3.7.1
• Migrating from 3.7.1 to 3.7.2
• Migrating from 3.7.2 to 3.7.3
• Migrating from 3.x to 4.0.0b1
• Migrating from 4.0.0 to 4.0.1
• Migrating from 4.0.0b1 to 4.0.0b2
• Migrating from 4.0.0b2 to 4.0.0
• Migrating from 4.0.1 to 4.0.2
• Migrating from 4.0.2 to 4.0.3
• Migrating from 4.x to 5.0.0b1
• Migrating from 5.0.0 to 5.0.1
• Migrating from 5.0.0b1 to 5.0.0b2
• Migrating from 5.0.0b2 to 5.0.0rc1
• Migrating from 5.0.0rc1 to 5.0.0
• Migrating from 5.0.1 to 5.1.0
• Migrating from 5.1.0 to 5.2.0
• Migrating from 5.2.0 to 5.3.1
• Migrating from 5.3.1 to 5.4.0
• Migrating from 5.4.0 to 5.4.1
• Migrating from 5.4.1 to 5.4.2
• Migrating from 5.4.2 to 5.5.0
• Migrating from 5.5.0 to 5.5.1
• Migrating from 5.5.1 to 5.5.2
• Migrating from 5.5.2 to 5.5.3
• Migrating from 5.x to 6.0.0
• Migrating from 6.3.1 to 6.3.2
• Migrating from 6.3.2 to 6.3.3
• Migrating from 6.3.3 to 6.3.4
• Migrating from 3.3.4 to 3.6.5
• Migrating from 3.3.5 to 6.3.6
• Migrating from 3.3.6 to 6.3.7