旧版本升级指南

2020年12月28日版本升级注意事项(to_20201015)：

1.鬼策老用户如需升级2020年12月28日及以后的版本，须文件覆盖后，运行/tools/update_base_to_20201015.py程序升级数据表。该操作不可逆，但升级后的数据表与老版本鬼策兼容。但程序与老版本鬼策不兼容，需要完整覆盖安装目录才能继续运行。建议新老版本分开两个目录放置。clone新目录->升级->运行新目录的程序即可。

2.由于TiDB v4的新特性，鬼策缩短了一些之前预留较长的字段，以提高兼容性，mysql版本也不需要额外使用安装程序，统一使用/component/setup.py安装即可。缩短后我已经在生产环境使用超过半个月，尚无不良影响。如果您的应用环境特殊，请谨慎升级TiDB到v4及以后版本，并自行修改建表程序中的字段长度。如果您的鬼策是在TiDB v3环境下安装的，那么升级到TiDB v4后，字段长度不会改变，依然有效。

2021年03月15日版本升级注意事项(to_20210226)：

1.2020年12月28日之前版本的鬼策老用户如需升级2021年03月15日及以后的版本，须文件覆盖后，运行/tools/update_base_to_20210226.py程序升级数据表。或2020年12月28日之后版本的鬼策老用户如需升级2021年03月15日及以后的版本，须文件覆盖后，运行/tools/update_20201015_to_20210226.py程序升级数据表。该操作不可逆，但升级后的数据表与老版本鬼策兼容。但程序与老版本鬼策不兼容，需要完整覆盖安装目录才能继续运行。建议新老版本分开两个目录放置。clone新目录->升级->运行新目录的程序即可。

2.黑名单开关可以在configs/admin.py里配置

2021年05月19日版本升级注意事项(to_20210406)：

1.2021年5月19日之前的版本升级到这个版本，须文件覆盖后，运行/tools/下对应的版本to_20210406的程序升级数据库。

2.接入控制的全局参数在"configs/admin.py"里配置。项目全局阈值在project_list表里配置。事件阈值在{project}_properties里配置。事件优先于项目全局优先于全局。具体可在"docs/接入控制"下找到文档，包含整个功能的介绍

3.该版本后，将不再提供跨版本的升级程序。今后再发布更新，将仅提供从该版本升级或全新安装。

4.此次更新修改了trigger功能kafka消费组的名字。如果独立订阅的，为了避免部分数据重复。所以默认订阅方式改为了latest。可在/configs/kafka.py下自行修改为需要的订阅方式。

2023年05年28日版本升级注意事项(update_shortcut):

1.此次升级仅提供从20210406的版本升级。再之前的版本使用，请先升级到20210406再进行。

2.覆盖除configs目录外的所有目录。

3.查看 /tools/update_shortcut.py 下 import_list 变量，看是否需要增加。默认是转换导入和神策迁移的。使用suoim或微博的链接是不会转化的。目的是进一步缩短短链的长度。如果用量够大，真的顶到了跟微博或suoim重合，也有正常跳过不会重复，连着1000个重号（几乎不可能），才会抛1个错。但是不会造成执行不下去。如果真的是希望接着suoim或者微博的短链后面，保证短链长度的一致性。可以自行添加。

4.执行 /tools/update_shortcut.py 等待升级完成。升级完会有提示。

5.重启 /flash_main.py。后续再请求生成短链，就不依赖任何第三方接口了。如果仍然希望使用第三方接口生成短链，可以在 /component/shorturl.py 中添加。