从 Cloudlog 迁移到 Wavelog
从 Cloudlog 迁移到 Wavelog
目录
信息（开始前请阅读）
自 2024 年初起，我们在这里提供了一份教程，讲解如何把已有的 Cloudlog 安装迁移到 Wavelog。它在很长一段时间内都运作良好。然而，随着两个项目各自独立演进，代码库已经分化到无法再保证干净迁移的程度。
因此我们强烈建议不要使用这份教程，而是参照本 Wiki 中的某份指南全新安装 Wavelog，然后手动导入你的 QSO、设置和台站配置。是的，这需要多花一点功夫——但从第一天起你就拥有干净、高性能的 Wavelog 环境。
如果你仍想尝试旧的迁移路径，下面保留了已弃用的教程。请注意，我们无法为这条迁移路径引发的任何问题提供支持。
Vy 73 de Wavelog 开发团队
危险：立即停止
只有在你清楚自己在做什么时才继续。我们不再为这条迁移路径提供支持。
警告
在做任何更改之前，备份所有内容（文件和数据库）！！
严格遵循每一步，并阅读全部内容！
如果你现有的 Cloudlog 安装是 2.6.7 或更早的版本，从 Cloudlog 迁移到 Wavelog 很容易。你不必做任何数据库更改！随时都可以迁移。但别担心，即使是更高的版本，你也可以迁移到 Wavelog！
请记住，你会失去 CloudLog 2.6.7 之后实现的功能。另一方面，你会获得多得多的稳定性、性能以及更多其他东西……
注意
迁移后，你应该清除浏览器缓存，或在浏览器中执行强制刷新：
Windows：Ctrl + F5
Mac：Cmd + Shift + R
别忘了本页末尾的「迁移后」步骤。
准备工作
为了成功把现有的 Cloudlog 安装迁移到 Wavelog，你首先必须设置正确的迁移版本。
用你喜欢的编辑器编辑文件 application/config/migration.php。本例中我们使用命令行里的 nano。
cd /var/www/html
nano -l application/config/migration.php
我们假设 Cloudlog 安装在 /var/www/html 文件夹中。如果你的安装位于其他文件夹，请相应修改此命令。
现在，在编辑 migration.php 时，确保 Line 25 上的迁移版本值为 170。
<?php
$config['migration_version'] = 170;
危险
如果你的迁移版本是低于 170 的任何数字，请先把 Cloudlog 安装更新到最新版本。
用 Ctrl + X、Y 和 Enter 保存文件
把迁移版本改为 170 之后，回到浏览器并重新加载 Cloudlog。你可以在管理菜单的 ADMIN -> Debug Information 中核实正确的版本号。像 Not possible, sorry. 这样的消息可以忽略！
你已成功把 Cloudlog 安装降级到 2.6.3 版本。
现在关闭 Web 服务器，以免在更改配置时出现问题
例如：
systemctl stop apache2
如果你使用 git clone 安装了 Cloudlog
如果 Cloudlog 是用 git clone 安装的，迁移过程相当简单。由于我们在 .gitignore 中设置了重要数据，你特有的用户数据不会受影响。
你首先必须更改 git 拉取数据的远程 URL。
git remote set-url origin https://www.github.com/wavelog/wavelog
获取新设置 URL 的 git 信息。
git fetch origin
如果此时你直接执行 git pull，会收到存在未提交更改的警告。要现在从 GitHub 拉取 Wavelog，你可以把与你现有 Cloudlog 安装不同的那些更改「暂存」（stash）起来。
git stash
现在我们可以从 GitHub 拉取 Wavelog 了。
git pull --rebase
可选： 如果你不想「暂存」这些东西（需要一点存储空间），也可以执行硬重置，它会忽略所有更改并获取 Wavelog 的文件。但请注意，这是非常强硬的做法。
git reset --hard origin/master
如果你用 ZIP 文件安装 Cloudlog，或使用托管空间
如果你的 Cloudlog 实例是通过单纯的 ZIP 文件安装的，或你使用的是托管空间，那么迁移过程与更新实例相同。
记得备份 Cloudlog 文件夹和数据库！！
- 下载最新发行版的 Wavelog ZIP 文件并解压。
https://github.com/wavelog/wavelog/releases
- 现在从你现有的安装中下载以下文件和文件夹：
- 文件：
application/config/config.php - 文件：
application/config/database.php - 文件夹：
uploads/ - 文件夹：
images/eqsl_card_images/ - 文件夹：
assets/qslcard/ - 如果存在：
- 文件：
assets/js/sections/custom.js
- 现在把这些文件和文件夹复制到新下载的 Wavelog 数据中。 另一种做法是直接用 (S)FTP 登录并上传 Wavelog 文件夹，然后接受「是否覆盖？」的提示。
- 完成后，你就可以用准备好的 Wavelog 文件夹替换整个 Cloudlog 文件夹。
- 现在重新加载网页。此时你应该能看到 Wavelog 已运行。
迁移后步骤
在成功把 Cloudlog 安装迁移到 Wavelog 之后，你应该检查一些事项。
之前关闭的 Web 服务器，你可能想重新启动它
systemctl restart apache2
警告
重启 apache2 后的第一次页面加载可能要等很久，因为首次页面加载会触发必要的数据库迁移和更改。所以别担心，耐心等待 :)
注意
迁移后，你应该清除浏览器缓存，或在浏览器中执行强制刷新：
Windows：Ctrl + F5
Mac：Cmd + Shift + R
-
检查你当前的配置
application/config/config.php，并与示例配置application/config/config.sample.php对比。你应确保当前配置包含与示例配置相同的内容。例如你想把$config['app_name']设置为「Wavelog」。 -
确保所有文件夹和文件都拥有 Web 服务器的正确所有者权限：
例如：
sudo chown -R www-data:www-data /var/www/html
感谢选择 Wavelog。如果你遇到任何问题或仍有疑问，请使用讨论区。