转载

openfire数据库安装指南

Openfire的所有数据存储在后端数据库中。如果您选择不使用嵌入式数据库，则必须设置和管理外部数据库的应用程序。本文档提供了安装说明，所有目前支持的数据库。 JDBC 2.0是Openfire的沟通与您的数据库所需的驱动程序，建议设定特定的数据库驱动程序。 Openfire的捆绑MySQL和Postgres，Microsoft SQL Server的HSQLDB JDBC驱动程序。可用的JDBC驱动程序的完整列表，请参阅： http://industry.java.sun.com/products/jdbc/drivers. 所有的数据库架构都可以在resources/database 目录中找到需要注意的是，除了那些在此列表中，可以支持额外的数据库。请检查您的数据库架构的版本，或考虑自己创建一个模式，如果你不能提供。从下面的列表中设置的详细信息，选择您的数据库：

MySQL
Oracle
Microsoft SQLServer
PostgreSQL
IBM DB2
HSQLDB

MySQL

JDBC 驱动 MySQL的JDBC驱动程序是和Openfire捆绑在一起的,所以你并不需要下载和安装一个单独的驱动程序。在openfire安装过程中，你可以填写入下面的值

driver: com.mysql.jdbc.Driver

server: jdbc:mysql://[YOUR_HOST]/[DATABASE_NAME]

JDBC Drivers[YOUR_HOST]和[DATABASE_NAME]为你的服务器的实际值。在许多情况下，当你的数据库运行在同一台服务器作为您的网络服务器，localhost是一个合适的值[YOUR_HOST]。 安装步骤 确认你使用的 MySQL数据库版本是 4.1.18 or更高版本 (5.x 建议版本) ¹.

创建数据库 mysqladmin create databaseName(注意: "databaseName" 可以像'openfire'一样的)

从安装文件夹resources/database 目录下的导入数据库模式 Unix/Linux: cat openfire_mysql.sql | mysql databaseName; Windows: type openfire_mysql.sql | mysql databaseName;

启动Openfire的安装工具，并使用适当的JDBC连接设置.

大于255的字符字段到MySQL4.1.18之前的版本不支持。如果你不能MySQL升级到最新版本，您将需要更改数据库的脚本。特别是，在/database/openfire_mysql.sql 脚本中用VARCHAR（255）代替VARCHAR（1024）。 字符编码问题 MySQL没有适当的Unicode支持，这使得数据支持，在非西方语言上有困难。然而，MySQL的JDBC驱动程序有一个解决方法，可以通过添加useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8的JDBC驱动程序的URL启用。您可以编辑conf/openfire.xml中的文件，以添加该值。注：如果您使用的机制配置JDBC URL是基于XML的，你需要使用XML字符文字 & 来隔开配置参数，符号是为XML保留字符。 更多帮助 如果您需要设置MySQL的帮助，请参阅以下网站： MySQL Reference Manual

Oracle

JDBC 驱动 推荐The Oracle 11g "thin" 驱动，它可以从 Oracle's website.下载不同版本thin 驱动是可用的, 但是建议使用（11.2.0.1.0 或者更高版本的）.如果你使用的是Java1.6，则使用”ojdbc5.jar的“。将您的JDBC驱动程序安装到Openfire的lib /目录下。在Openfire的基于Web的安装工具，使用以下值：

driver: oracle.jdbc.driver.OracleDriver

server: jdbc:oracle:thin:@[HOST]:[PORT]/[SERVICE]

[HOST]， [PORT] 和[SERVICE] 为你的服务器的实际值。在许多情况下，当你的数据库运行在同一台服务器作为您的网络服务器， localhost和1521是合适的值[HOST]和[PORT]。服务名称请咨询您的DBA 安装步骤 首先，创建一个“Jive”用户或其他用户(将“own”的Jive表)。这是没有必要的，但这样做可以让你的表存在于一个单独的表空间。接下来导入数据库模式,文件在resources/database目录。安装使用sqlplus（或您最喜爱的Oracle工具，如Toad）。 SQLPLUS：复制“openfire_oracle.sql”的文件的同一目录下sqlplus的安装（应该是类似// Oracle/Ora81/bin）。接下来，登录到sqlplus，然后执行以下命令：@ openfire_oracle，这将导入数据库架构文件。现在设置你的数据库

SQL Server

JDBC 驱动 Openfire 包含 the Free TDS JDBC 驱动,它是连接sqlServer数据库推荐的驱动程序，为了连接 SQL Server,基于web的工具设置以下值：

driver -- net.sourceforge.jtds.jdbc.Driver

server -- jdbc:jtds:sqlserver://[host-name]:[port-number]/[database-name];appName=jive

[host-name]是你的数据库服务器的主机名或IP地址， [port-number]的SQLServer监听端口（通常是1433）和 [database-name]是数据库名称（名称参数是可选的） 安装说明

使用企业管理器创建一个新的数据库，如果已经有一个数据库，你要使用。您不妨来命名数据库“openfire的”。

创建一个用户来访问数据库，如果已经有一个你想使用的。需要注意用户的默认数据库是一个你在第1步中创建的。

打开查询分析器连接到服务器。.

选择您要使用的Openfire从DB下拉（你在步骤1中创建的，如果你正在使用一个新的数据库）的数据库。

打开的openfire_sqlserver.sql文件。

按F5来运行该脚本。该脚本将运行并创建必要的表。

继续到Openfire安装工具，并在出现提示时，使用适当的JDBC设置。

PostgreSQL

JDBC 驱动 openfire绑定了PostgresSql的jdbc驱动，因此你不必要再单独去下载驱动了通过web方式配置，使用以下值：

driver -- org.postgresql.Driver

server -- jdbc:postgresql://[HOST_NAME]:[PORT_NUMBER]/dbname

如果跳过了，host默认为locahost(not 127.0.0.1) ，端口则是5432 安装说明

创建数据库. 例如, 使用 PostgreSQL "createdb" 工具:

createdb -E UNICODE openfire

导入数据库模式（在 resources/database 目录中）. 使用 psql (或者你喜欢Postgres sql工具) 来导入openfire数据库模式

psql -d openfire -f openfire_postgresql.sql

.进行设置适当的Openfire JDBC设置会有提示。

IBM DB2 7

JDBC 驱动 使用JDBC 1.2兼容的驱动db2java.zip (1293KB)，位于"%DB2PATH%java2",拷贝驱动到openfire安装目录下lib/ 配置的值如下所示:

driver: COM.ibm.db2.jdbc.app.DB2Driver

server: jdbc:db2:DB NAME, e.g. JIVE

如果你使用远程数据库的话，你可以使用以下配置：

driver: COM.ibm.db2.jdbc.net.DB2Driver

server: jdbc:db2:DB NAME, e.g. JIVE

安装说明 你必须创建一个新的数据库 (e.g. JIVE)或者使用存在的数据库,.使用有效的用户名连接数据库来创建表和索引。记住,DB2 UDB应用用户名称作为表模式。当你使用相同的用户管理界面配置Jive。命令如下记住,DB2 UDB应用用户名称作为表模式。当你使用相同的用户管理界面配置愚弄。命令如下: DB2 CREATE DB JIVE ALIAS JIVE DB2 CONNECT TO JIVE USER DBUSER USING DBPASSWORD(or you can use the Command Center GUI) 启动DB2的命令（window下），或者在unix上用脚本导入数据库模式(文件在resources/database目录中) db2 -tvf openfire_db2.sql 或者,使用DB2命令中心和运行脚本通过“复制源”在数据库文件夹树。数据库现在已经建立

HSQLDB

特别注意 Openfire束作为嵌入式数据库的hsqldb。如果你选择使用嵌入式数据库,它可以通过安装配置Openfire。如果你有一个独立的安装HSQLDB,遵循下面的说明连接到它。 JDBC 驱动因为是嵌入在Openfire hsqldb,没有必要单独下载JDBC驱动程序。配置文件的值是:

driver: org.hsqldb.jdbcDriver

server: jdbc:hsqldb:[]

例如,服务器URL可能是 jdbc:hsqldb:../database/defaultdb 设置说明 创建一个数据库的Openfire表。这是假设你已经安装在自己的目录HSQLDB和正常工作。

运行HSQLDB数据库管理器导航到文件夹HSQLDB。jar位于和类型以下

java - cp hsqldb. jar org.hsqldb.util.DatabaseManager 然后回车。你将看到一个GUI应用程序。注意,你不会看到一个hsqldb.jar的Openfire分布------这是指hsqldb. jar从HSQLDB分布。

当提示在连接窗口中,输入org.hsqldb.jdbcDriver 当驱动,并指定数据库的URL在URL字段。默认的密码已经输入。

现在复制并粘贴openfire_hsql.sql的内容( resources/database)到命令窗口,并击中执行。如果没有错误的报告,那么你的数据库设置正确。

最后,你应该改变用户名和密码登录数据库:就打开脚本文件在数据库文件夹和更改合适的值。确保你不使用空白密码,因为Openfire不支持。