Skip to content

Migration Guides

This page provides step-by-step migration guides for upgrading between major versions of Arctyk ITSM.

General Migration Process

When upgrading Arctyk ITSM between versions, follow these general steps:

  1. Backup your database - Always create a backup before upgrading
  2. Review the changelog - Check for breaking changes in the target version
  3. Update dependencies - Install new requirements from requirements.txt
  4. Run migrations - Apply database schema changes with python manage.py migrate
  5. Collect static files - Run python manage.py collectstatic
  6. Restart services - Restart your web server and Celery workers
  7. Test thoroughly - Verify critical functionality after upgrade

Migrating from 0.4.x to Future Versions

Coming Soon

Migration guides will be added here as new major versions are released.

Migrating from 0.3.x to 0.4.x

Breaking Changes

  • Recurring Tickets Removed: The recurring ticket feature has been temporarily removed and will be reintroduced in a future version with improved architecture.
  • UI Overhaul: Custom CSS or JavaScript that relied on legacy UI elements may need updates.
  • Workflow Changes: Ticket status workflow now follows Jira-style category-based transitions.

Migration Steps

  1. Remove recurring ticket references: If you have any custom code or integrations that reference recurring tickets, remove or comment them out.

  2. Update static assets: The SCSS architecture has been reorganized. If you have custom styles, you may need to adjust import paths.

  3. Review workflow transitions: The ticket workflow system now uses category-based transitions. Review your custom workflows and update them to use the new WORKFLOW_TRANSITIONS pattern.

  4. Test AJAX forms: The Create and Update ticket forms now return JSON for AJAX requests. If you have custom JavaScript, ensure it handles JSON responses correctly.

Migrating from 0.2.x to 0.3.x

Migration Steps

  1. Update Django to the required version
  2. Run database migrations
  3. Update any custom templates that reference legacy models
  4. Test ticket creation and workflow transitions

Database Backup Best Practices

Before any migration:

# PostgreSQL backup
pg_dump -U arctyk_user arctyk_db > backup_$(date +%Y%m%d_%H%M%S).sql

# Restore if needed
psql -U arctyk_user arctyk_db < backup_20250101_120000.sql

Rollback Procedure

If a migration fails or causes issues:

  1. Stop the application services
  2. Restore the database from backup
  3. Revert to the previous application version
  4. Restart services
  5. Investigate the migration issue before attempting again

Getting Help

If you encounter issues during migration: