升级文档

升级及迁移请保持 SECRET_KEY 与旧版本一致，否则会导致数据库加密数据无法解密

环境说明

  • 从 v2.5 开始，要求 MySQL >= 5.7
  • 从 v2.6 开始，要求 Redis >= 6
  • 推荐使用外置 数据库 和 Redis，方便日后扩展升级
DBVersionCacheVersion
MySQL>= 5.7Redis>= 6.0
MariaDB>= 10.2

升级说明

要求说明

  • jumpserver 版本 >= v2.6.0
  • jumpserver 版本 < v2.6.0 的请先参考上面的迁移文档迁移到最新版本

升级步骤

操作步骤

  1. cd /opt
  2. yum -y install wget
  3. wget https://github.com/jumpserver/installer/releases/download/v2.12.2/jumpserver-installer-v2.12.2.tar.gz
  4. tar -xf jumpserver-installer-v2.12.2.tar.gz
  5. cd jumpserver-installer-v2.12.2
  1. ./jmsctl.sh upgrade
  1. 是否将版本更新至 v2.12.2 ? (y/n)  (默认为 n): y
  3. 1. 检查配置变更
  4. 配置文件位置: /opt/jumpserver/config
  5. /opt/jumpserver/config/config.txt  [ √ ]
  6. /opt/jumpserver/config/core/config.yml  [ √ ]
  7. /opt/jumpserver/config/koko/config.yml  [ √ ]
  8. /opt/jumpserver/config/mariadb/mariadb.cnf  [ √ ]
  9. /opt/jumpserver/config/mysql/my.cnf  [ √ ]
  10. /opt/jumpserver/config/nginx/lb_http_server.conf  [ √ ]
  11. /opt/jumpserver/config/nginx/lb_rdp_server.conf  [ √ ]
  12. /opt/jumpserver/config/nginx/lb_ssh_server.conf  [ √ ]
  13. /opt/jumpserver/config/redis/redis.conf  [ √ ]
  14. /opt/jumpserver/config/nginx/cert/server.crt  [ √ ]
  15. /opt/jumpserver/config/nginx/cert/server.key  [ √ ]
  16. 完成
  18. 2. 检查程序文件变更
  19. 完成
  21. 3. 升级镜像文件
  22. Docker: Pulling from jumpserver/core:v2.12.2        [ OK ]
  23. Docker: Pulling from jumpserver/koko:v2.12.2        [ OK ]
  24. Docker: Pulling from jumpserver/web:v2.12.2         [ OK ]
  25. Docker: Pulling from jumpserver/redis:6-alpine      [ OK ]
  26. Docker: Pulling from jumpserver/mysql:5             [ OK ]
  27. Docker: Pulling from jumpserver/lion:v2.12.2        [ OK ]
  28. 完成
  30. 4. 备份数据库
  31. 正在备份...
  32. mysqldump: [Warning] Using a password on the command line interface can be insecure.
  33. [SUCCESS] 备份成功! 备份文件已存放至: /opt/jumpserver/db_backup/jumpserver-2021-03-19_08:32:39.sql
  35. 5. 进行数据库变更
  36. 表结构变更可能需要一段时间, 请耐心等待
  37. 检测到 JumpServer 正在运行, 是否需要关闭并继续升级? (y/n)  (默认为 n): y
  39. Stopping jms_core ... done
  40. Stopping jms_koko ... done
  41. Stopping jms_lion ... done
  42. Stopping jms_web ... done
  43. Stopping jms_celery ... done
  44. Removing jms_core ... done
  45. Removing jms_koko ... done
  46. Removing jms_lion ... done
  47. Removing jms_web ... done
  48. Removing jms_celery ... done
  50. 2021-03-19 08:32:44 Collect static files
  51. 2021-03-19 08:32:44 Collect static files done
  52. 2021-03-19 08:32:44 Check database structure change ...
  53. 2021-03-19 08:32:44 Migrate model change to database ...
  55. 473 static files copied to '/opt/jumpserver/data/static'.
  56. Operations to perform:
  57.   Apply all migrations: acls, admin, applications, assets, audits, auth, authentication, captcha, common, contenttypes, django_cas_ng, django_celery_beat, jms_oidc_rp, ops, orgs, perms, sessions, settings, terminal, tickets, users
  58. Running migrations:
  59.   No migrations to apply.
  60.   # 有时候是下方红色的提示，忽略即可，不需要做处理。
  61.   Your models have changes that are not yet reflected in a migration, and so won't be applied.
  62.   Run 'manage.py makemigrations' to make new migrations, and then re-run 'manage.py migrate' to apply them.
  63. 完成
  65. 6. 清理镜像
  66. 是否需要清理旧版本镜像文件? (y/n)  (默认为 n): y
  67. Untagged: jumpserver/core:v2.11.3
  68. Untagged: jumpserver/luna:v2.11.3
  69. Untagged: jumpserver/lina:v2.11.3
  70. Untagged: jumpserver/koko:v2.11.3
  71. Untagged: jumpserver/lion:v2.11.3
  72. 完成
  74. 7. 升级成功, 可以重新启动程序了
  75. cd /opt/jumpserver-installer-v2.12.2
  76. ./jmsctl.sh start
  1. ./jmsctl.sh start