View source for 还原

<!-- BEGIN interlang links -->
<!-- Do NOT edit this section
     Links below are automatically managed by PolyglotBot
     You can edit links on the English source page : Restores -->
[[en:Restores]]
[[fr:Restaurations]]
[[es:Restauraciones]]
<!-- END interlang links -->

[[Category:管理]]
{{Template用户手册}}

本页介绍如何还原Dolibarr的备份（如在硬盘被格式化后）。要了解如何进行完整备份，请参阅 [[备份]] 页面。

=前提条件=
要在干净的环境中进行一个完整的还原，必需：

*拥有数据库的完整备份（例如，使用mysql的工具mysqldump把MySQL或MariaDb数据库备份到转储文件中）。
*拥有 documents 目录中所有文件的完整备份。
*拥有用于访问已备份的 Dolibarr 的管理员用户的登录名和密码。

=步骤 1 - 重新安装 Dolibarr 软件=
如果您已经卸载了Dolibarr或因为使用新服务器而尚未安装Dolibarr，则应先安装Dolibarr，使其拥有一个新的干净的数据库。

需要使用与以前相同类型的数据库（MySQL、PostgreSQL...）。

您可以选择任何的 Dolibarr发行版（Dolibarr、DoliWamp、DoliMamp、DoliDeb或任何其他的Linux发行版...）进行安装；但是，它必须与备份期间使用的'''版本'''（vX.Y）'''完全相同'''（如果您想升级版本，建议稍后再进行）。

注意：如果备份是使用 Dolibarr 进行操作的，则备份的Dolibarr版本信息包含在数据库备份文件的名称中。

=步骤 2 - 还原文档=
在新安装的Dolibarr上，使用管理员帐户前往菜单 '''主页>管理工具>还原''' 。

Dolibarr将通过以下消息向您显示文档文件目录的存储位置：
 Pour restaurer une sauvegarde de Dolibarr, vous devez:
 
 * Reprendre le fichier archive (fichier zip par exemple) du répertoire documents et en extraire l'arborescence dans le répertoire documents d'une nouvelle 
   installation de dolibarr ou dans le répertoire documents de cette installation ('''''chemin du répertoire des documents''''').
此目录必须为空（否则，可以清除其内容）。 您所要做的就是将备份的目录内容复制到该目录中。
=步骤 3 - 还原数据库=
==MySql==
在非Linux平台上，如果DOS无法识别'''mysql'''命令，这意味着PATH变量未指向 mysql.exe 所在的目录。 它必须：

*在系统变量PATH中添加mysql.exe文件所在的目录；

*将备份转储文件复制到mysql.exe文件所在的目录；

如果备份文件是压缩文件，请先解压缩该文件。

例如，一个名为 mysqldump_dolibarr_2.7.0_200812021800.sql.bz2 的已压缩备份文件必需被解压缩为文件                      mysqldump_dolibarr_2.7.0_200812021800.sql（Linux平台启动命令bunzip myfile.bz2，Windows平台启动命令 7zip）。

在新安装的Dolibarr上，使用管理员帐户登录，然后前往菜单 '''主页 / 管理工具 / 还原''' 。

选择导入MySQL的方法。

然后，Dolibarr在命令行中显示一个命令，该命令带有隐藏密码，以执行数据库还原。单击“显示完整命令”以获得未隐藏密码的完整命令。

例如，我们将有：

<syntaxhighlight lang="bash">
mysql mydatabase -h localhost -u databaseuser -pdatabasepass < mybackupfile.sql
</syntaxhighlight>

其中：

*<syntaxhighlight lang="bash">
mysql mydatabase -h localhost -u databaseuser -pdatabasepass < mybackupfile.sql
</syntaxhighlight> 是包含Dolibarr数据的MySQL数据库的名称；
*<syntaxhighlight lang="bash">
mysql mydatabase -h localhost -u databaseuser -pdatabasepass < mybackupfile.sql
</syntaxhighlight>
*<syntaxhighlight lang="bash">
mysql mydatabase -h localhost -u databaseuser -pdatabasepass < mybackupfile.sql
</syntaxhighlight>
*<syntaxhighlight lang="bash">
mysql mydatabase -h localhost -u databaseuser -pdatabasepass < mybackupfile.sql
</syntaxhighlight>
*<syntaxhighlight lang="bash">
mysql mydatabase -h localhost -u databaseuser -pdatabasepass < mybackupfile.sql
</syntaxhighlight>
*<syntaxhighlight lang="bash">
mysql mydatabase -h localhost -u databaseuser -pdatabasepass < mybackupfile.sql
</syntaxhighlight>

打开命令行shell（Windows平台的DOS命令、Linux平台的shell终端...）。 

前往保存着要还原的备份文件和命令'''mysql'''.exe的目录。运行先前提供的命令，其中每个空格（或无空格）、“-”或“<”都是必需的，否则将会产生语法错误。

'''备选方案'''：您也可以使用 ''phpMyAdmin'' 的导入标签页来还原备份文件（通常，您不必选中任何特定选项，但备份文件必须绝对禁用 foreign_key_checks ，见下文）。然而，与上一方法不同的是，该方法不能保证提供的结果是正确的。
===故障排除===

[[File:Warning.png]] ERROR 1005 (HY000) at line 20: Can't create table `dolibarr`.`llx_accounting_account` (errno: 150 "Foreign key constraint is incorrectly formed")

=> 如果出现此类错误，则必须手动删除表 llx_accounting_account 和 llx_accounting_system，然后再次尝试加载。


[[File:Warning.png]] Error loading table on foreign key.

=> 必须在'''还原过程中禁用外键检查'''，否则由于外键之间的冲突，SQL备份将无法还原！如果备份正确，则应为默认情况。

示例：在SQL文件的开头和结尾添加FOREIGN_KEY_CHECKS：

<syntaxhighlight lang="sql">
-- SQL Dump
-- Server version: 5.5.8

SET FOREIGN_KEY_CHECKS=0;
SET SQL_MODE="NO_AUTO_VALUE_ON_ZERO";


/*!40101 SET @OLD_CHARACTER_SET_CLIENT=@@CHARACTER_SET_CLIENT */;
/*!40101 SET @OLD_CHARACTER_SET_RESULTS=@@CHARACTER_SET_RESULTS */;
/*!40101 SET @OLD_COLLATION_CONNECTION=@@COLLATION_CONNECTION */;
/*!40101 SET NAMES utf8 */;

CREATE TABLE IF NOT EXISTS `llx_accountingaccount` (

INSERT INTO ...

CREATE TABLE ...

INSERT INTO ...

...

SET FOREIGN_KEY_CHECKS=1;
</syntaxhighlight>

==PostgreSql==
使用一个类似于mysql的过程：'''pg_restore''' 。

{{ToComplete}}

=步骤 4 - 使用已还原的Dolibarr=
还原命令执行完成后，您可以重新登录Dolibarr。现在，您必须使用备份时存在的登录名。所有数据均为备份时的数据。

=相关视频=

将数据还原到Docker安装：

（法语配音，但字幕可用，并在此语言审查）

<youtube width="200" height="120">6H9ItBB_jK8</youtube>