||==================================||
   Discuz! X 转换文档
||==================================||

本文档用于帮助您将原有社区产品转换或者转换到 Discuz! X 系列产品。
在您开始转换之前，请务必逐条仔细阅读以下的注意事项：

1. 转换之前，为了确保无误，强烈建议您备份原有数据，我们无法对转换前没有备份的用
   户提供任何技术支持
2. 通常情况下，我们的转换程序放置在发行版本的 ./utilities/convert 目录中，此程序
   可以独立于产品运行
3. 我们不能保障转换或者转换到 Discuz! X 产品当中所有的数据都是有效的，某些插件或
   者自行开发的功能数据需要您自行转换
4. 大多数情况下，您转换到 Discuz! X 产品以后，需要进入后台进行一系列重新设置，否
   则某些功能可能无法正常使用。
5. 除非有特殊的声明，我们的转换程序不会改变您原有的数据格式和设置，他会将原有数
   据重新复制一份，并做格式转换。所以，在转换开始之前，您应当检查您的数据库存储   
   空间是否够用。假设您原有数据是 100M，您至少需要 110M 以上的数据剩余空间，否则
   可能无法转换成功
6. 转换成功后，请您删除 convert 程序，以避免可能的安全问题

+--------------------------------------+
 转换方法和步骤
+--------------------------------------+
1. 进入您原来的系统，关闭您的站点。
2. 进行数据备份，附件备份
3. 备份您的系统的配置文件 例如 config.inc.php，记录下当中的各种服务器信息，例如
   mysql 数据库
4. 将原有程序 全部转移到一个备份目录，例如 old
5. 上传 Discuz! X 程序到您的站点目录
6. 正确安装 Discuz! X （如果您的 UCenter Server 是独立安装的，您需要提供他的访问
   路径和创始人密码）
7. 上传 utilities 目录中的 convert 文件夹到您的站点根目录
   设置为可写（777）
8. 访问 http://您的域名/convert 开始转换/转换
9. convert 程序当中集成了多种程序可以转换到 Discuz! X，请您根据系统进行选择
10. 转换程序通常会提供一个转换或者安装说明，您在开始之前请仔细阅读他
11. 按照程序提示，直至所有转换执行完毕

+--------------------------------------+
 转换疑难解决
+--------------------------------------+
您在转换过程中遇到任何问题，可通过以下途径解决

1. 到我们的讨论区寻求帮助和支持
   https://www.discuz.vip

2. 查看详细转换指导文件
   https://www.dismall.com

3. 商业用户可以根据您购买的服务，使用电话、MSN、QQ、论坛等多种方式寻求技术支持


+--------------------------------------+
 常见问题和解答
+--------------------------------------+

1. 我必须要先安装 Discuz! X 么？
   通常是这样的，尤其是在进行转换的时候，这是最关键的一步，否则无法转换成功

2. 我已经安装了 Discuz! 论坛和 UChome 两个产品，可以转换到 Discuz! X 产品么?
   可以的。Discuz! X 融合了论坛和 SNS 的功能，转换以后，您的两个产品将会完美整合

3. 转换 Discuz! 和 UChome 有什么特殊要求么？
   在进行转换之前，您必须在站点上安装 DiscuzX 程序，并保证它可以正常运行。
   如果您仅仅安装了某一个产品，那么转换到 DiscuzX 是容易的，按照提示即可。
   如果您安装了两个或者多个产品，那么转换的时候要注意转换顺序，您首先应当转换论
   坛产品到 Discuz! X，然后再执行其他转换程序，转换 UChome 或者 Supesite

4. 为何我转换完毕以后，站点的用户都没有了
   转换程序只有检测到 UCenter 数据表的时候，才会转换用户数据。如果您以前使用的是
   我们提供的 Discuz! 完整版，转换程序可以自动检测到 UCenter 的。但是如果您使用的
   是自己独立安装的 UCenter，那么转换程序会检测不到。
   解决的办法：
       请重新安装您的 Discuz! X，安装的时候选择 仅安装 Discuz! X (手工指定已经安
   装的 UCenter Server)，然后填入您的 UCenter 的信息，并开始安装。安装完毕以后重新
   开始转换。

5. 我原来的论坛规模很大，转换程序对数据的大小有限制么？是否可能确保转换成功？
   我们的转换程序经过多次的测试，并在 >6G 的数据环境中反复转换成功，因此对于原始
   数据的大小是没有限制的，只不过随着数据量越大，转换时间越长。您应当保障
   数据转换期间，服务器一直是可用的。

6. 如果转换中途出错或者意外中断，该如何处理？
   如果出现意外中断，通常情况下您应当根据错误提示，排除错误，然后再重新开始。
   转换程序提供了高级转换模式，您可以选择跳过某些转换步骤，而不必重新来过，但您
   应当了解哪些步骤已经执行过，否则可能导致数据转换不完整。
   如果您是在转换 UChome 或者 Supesite 过程中出错，并且此时论坛已经转换完毕，
   那么您可能需要重新转换论坛，然后再执行 UChome 的转换，否则转换可能无法成功。
   因此，如果您需要转换论坛 + UChome + ... 多个程序，我们建议您在每个转换程序结束，
   对已经转换好的数据进行备份，这样可以在中断的时候，恢复备份，然后继续执行。

7. 转换过程中需要人工干预么？
   除了转换前面需要填写一些信息和选择转换程序，转换一旦开始，程序将会自动运行和
   跳转，所以您无需进行干预。不恰当的干预反而可能在成转换中断或者失败。