CWIKI.US 站长。 从事开发多年,在彷徨和迷失的边缘徘徊。
如果你遇到了下面的错误信息,例如: could not insert: [bucket.user.propertyset.BucketPropertySetItem#bucket.
如果你遇到了下面的错误信息,例如: com.atlassian.confluence.importexport.ImportExportException: Unable to complete import becaus...
错误可能是因为数据库突然不可访问而产生。也有可能是你备份文件有问题,你需要找到你 XML 备份文件中违反数据库规定的记录修改这个记录后再创建一个新的 XML 备份: 在实例开始恢复的时候,请按照下面的指南来禁用批量更新(针对简单的问题解决),启用 SQL 日志和SQL 查询日志,通过在 Enabling Detailed SQL Logging 页面中描述的参数(with parameters)。
XML 站点备份仅仅针对新数据库恢复的时候是必要的。 Upgrading Confluence,Setting up a test server 或者 Production Backup Strategy 最好还是通过备份 SQL 的方法来备份。
错误可能是因为数据库突然不可访问而产生。如果你在你的日志中看到了错误 'Couldn't backup database data' ,这个指南将会帮助你更正这个错误。
XML 站点备份仅仅被用于整合到一个新的数据库。设置一个测试服务器 或者 创建一个可用的备份策略 相对 XML 备份来说是更合适的策略。
每一个文件在恢复上传到 Confluence 的时候必须单独重命名,你可以通过下面说明的 3 个方法中选择一个进行操作: 选择 A - 通过文件名恢复附件 如果你知道你需要恢复的每一个文件名,尤其是你希望仅仅恢复一些文件: 解压备份目录然后打开 entities.xml。
备份的 ZIP 文件包含有 entities.xml,这个 XML 文件包含有 Confluence 的所有页面内容和存储附件的目录。
页面中的文件附件可以从备份中获得而不需要将备份文件导入到 Confluence 中。这个在用户删掉了附件,但是你还是想恢复这个附件的时候就变得非常有用了。
一般来说,Confluence 数据库可以从 Administration Console 或者 Confluence Setup Wizard 中进行恢复。
请参考 Restoring a Test Instance from Production 页面中的内容获得更多完整的说明。
如果你需要从 Confluence 5.3 及其早期版本中的导出文件恢复到晚于 Confluence 5.3 的 Confluence 中的话。
如果你在导入的时候遇到了问题,检查下面的一些提示。 你的文件太大而不能上传?这个是非常常见的错误。出现的原因是备份文件不能在规定的时间内上传到服务器上。
有下面 2 中方法可以导入一个空间——通过上传一个文件,或者从你 Confluence 服务器上的一个目录中导入。上传文件仅仅是针对一个小站点的情况。
你可以导出一个空间 – 包括页面,评论和附件到一个压缩的 XML 文件中,可选的你可以在 XML 文件中包括所有空间使用的附件。
推荐使用生产备份策略。我们推荐你针对你的生产环境中使用的 Confluence 参考 Production Backup Strategy 页面中的内容进行备份和恢复(这个需要你备份你的数据库和 home 目录)。
如果你在导入的时候遇到了问题,检查下面的一些提示。 你的文件太大而不能上传?这个是非常常见的错误。出现的原因是备份文件不能在规定的时间内上传到服务器上。
有下面 2 种类方法可以导入一个站点 - 通过上传一个文件或者从你 Confluence 服务器上读取一个目录。上传文件仅仅是针对一个小站点的情况。
这个页面对如何从一个 XML 导出文件中恢复到一个已经存在的 Confluence 站点进行描述。 如果你希望导入数据倒一个新的站点,请参考 restoring from backup during setup 页面中的内容。
Confluence 将会创建备份,同时压缩 XML 文件后存储熬你的 /backups> 目录中。你需要自己访问你安装的 Confluence 服务器,并且从服务器上获得这个文件。
希望为你的站点创建一个 XML 导出文件: 进入 > 基本配置(General Configuration) > 备份和恢复(Backup & Restore)。
Confluence 被配置自动备份数据,使用压缩的 XML 格式。同时你也可以通过 Confluence 的 管理员控制台(Administration Console)手动进行备份。
下面的代码是用户提交的,在使用的时候需要小心,因为 Atlassian 不提供这些代码的技术支持。如果你在使用或者修改这些代码的时候有任何问题,请粘贴到 post them to Atlassian Answers。
如果你希望关闭自动备份,你可以选择手动导出保存站点。请参考 Manually Backing Up the Site 页面中的内容获得更多的信息。
希望配置 Confluence 备份: 进入 > 基本配置(General Configuration) > 备份管理(Backup administration)。
Confluence 的自动备份被设置为每天凌晨 2:00 进行全站导出。压缩的 xml 备份文件存储在你 Confluence Home directory 的 backups 目录中。
XML 备份被描述用于在 Confluence 备份使用的其他方法,例如升级和移动服务器。使用上面描述的备份和恢复方法也适用这些地方。
如何备份 有关备份你数据库使用的命令与你使用的具体数据库有关,例如针对 PostgreSQL 数据库,备份命令为 pg_dump dbname > outfile。
备份整个 home 目录是最安全的选项。但是,有很多目录是在 Confluence 启动的时候创建的并且也是可以忽略的。不管那些文件夹可以忽略,下面的文件夹必须进行备份才能回复: /confluence.cfg.xml /attachments (如果你的备份磁盘空间比较紧张的话,你可以不包含解压的文本) 下面的目录将会在 Confluence 启动的时候自动创建。
Atlassian 推荐创建一个可选的数据库备份方案: 使用你数据库提供的备份和恢复工具 为了避免数据不完整和备份中断,我们推荐你在备份和恢复 Confluence 数据库的时候关闭 Confluence 实例。
如果你是下面的情况,Confluence 的自动每日 XML 备份可能适合你: 正在评估使用 Confluence 你对数据库的管理并不是非常熟悉同时你的 Confluence 安装实例的数据量并不大 一旦你的 Confluence 安装实例中超过了上千的页面,相对数据库自带的数据备份来说,XML 的备份方案就显得没有那么有效了。
Confluence 的 Attachment Storage Configuration 可以配置 Confluence 将附件存储在 home directory,或者是存储在数据库中。
XML 站点备份的方式只针对 Confluence 包含有几千页面的情况,XML 备份所需要的时间随着数据量的变化而增加。另外的一个问题是 XML 站点的备份将会包含上 G 的附件数据,随着数据量的增加,磁盘使用量也会显著增加。
Atlassian 推荐针对生产环境中安装使用的 Confluence 使用原始数据库工具备份策略。 在默认的情况下,Confluence 每天都会备份所有数据和附件到 XML 文件备份中。
如果你对 Confluence 进行升级(手动或者使用安装器),你需要: 停止 Confluence (如果你已经尝试开始启动)。
如果你希望在使用 JDBC 直接方式的应用中切换到使用数据源: 停止 Confluence. 备份下面的文件,以防止你可能需要重新恢复你的配置: /conf/server.xml /confluence/WEB-INF/web.xml /confluence.cfg.xml 请按照上面新安装使用的步骤,同时拷贝你的驱动并且将数据源添加到正确的文件中。
如果在你的 Tomcat 中配置了数据源,并且Confluence 设置指南在安装的时候检测到这个配置的时候,配置数据源的选项将会提供给你进行配置。
这个指南指导你如何配置使用 JNDI 数据源来连接到你的数据库。使用这个类型的连接,Confluence 将会询问应用服务器(Tomcat)中你配置的连接信息。
确定 Confluence 在数据库连接池中校验数据库连接: 停止 Confluence。 编辑 /conf/server.xml 文件(或者基于在那里你配置你的数据源)。
确定 Confluence 在数据库连接池中校验数据库连接: 停止 Confluence。 编辑 confluence.cfg.xml 文件。
不同的数据库通常要求不同的 SQL 校验查询。校验查询通常需要尽可能的简单,这个查询在链接从数据库连接池中取出的时候都会被执行一次。
当数据库服务器进行重启或者因为网络问题导致连接中断。所有在数据库连接池中的连接都会被中断。希望处理这个问题,通常需要 Confluence 进行重启。
如果数据库的查询时间太长同时你的应用程序显示没有响应,你可以配置数据库的查询超时时间。在默认情况下 Confluence 没有超时时间。
针对已经存在的 Confluence 安装,如果你安装的 Confluence 版本是 6.4 或者早期的版本,我们在安装的时候没有检查你数据库的字符设置。
Confluence 和你的数据库必须配置使用相同的字符集。 Confluence 使用 UTF-8 字符集编码,所以你的数据库也必须配置为使用 UTF-8 (或者与 UTF-8 相同的编码,例如在 Oracle 中使用的 AL32UTF8 编码)。
'Collation' 是数据如何被存储和比较的规则。大小写是否敏感是有关字符集设置的一个方面。其他大小写敏感的方面有 kana (Japanese script)和宽度(单字节对比双字节长度)。
设置准备 这个方法仅仅针对附件存储在文件系统中。如果你存储附件在数据库中,请参考 Attachment Storage Configuration 文档中的内容来找到如何在 2 种不同的文件存储方式之间进行整合。
步骤 1:对你的插件进行记录 对你近期在 Confluence 中安装和启用的插件进行记录,这你可以在后期对插件进行重新安装或者调整。
数据库整合的限制 注意: Confluence 自带的 XML 方式导出方法并不适用于备份和整合大数据集。这里有一些第三方的数据库工具你可以使用能够帮助你对大数据集进行备份和整合。
这个文档描述了如何整合你的 Confluence 数据库从你已经存在的数据库上到其他的数据库。这个指南被用来指导你从使用评估数据库转移到使用生产数据库。