中文标题【设置 Oracle 数据库】
1. 安装 Oracle
如果你还没有在安装可以连接的 Oracle 数据库,请先下载后进行安装。请参考 Oracle 文档 来获取有关安装的指南。
当你设置你的 Oracle 服务器的时候:
- 字符集 必须使用 AL32UTF8 字符集(这个字符集在 Oracle 相当于 Unicode UTF-8 编码)。
2. 创建数据库用户
创建用户后并且指派权限:
使用
sqlplus
命令行工具通过命令行来访问 Oraclesqlplus user/password <as sysdba|as sysoper>
如果你的登录用户使用的是 'sys' 你需要将 "as sysdba" 或 "as sysoper" 来确定你希望使用的何种 sysy 权限。
创建 Confluence 用户(例如
confluenceuser
),然后仅给这个用户赋予下面的权限:create user <user> identified by <password> default tablespace <tablespace_name> quota unlimited on <tablespace_name>; grant connect to <user>; grant resource to <user>; grant create table to <user>; grant create sequence to <user>; grant create trigger to <user>;
Confluence 这个必须用户具有上面描述的的权限。Confluence 仅仅要求上面的这些权限就可以了,因此你需要指派特定的权限给这个用户。这个用户不需要创建表,创建序列,创建触发器这些权限角色。
不要赋予这个用户
select any table
权限。这个权限将会导致其他 schemas 的问题。当你创建用户的时候,为上面显示表对象指定
tablespace
。
3. 安装 Confluence
请参考 Confluence Installation and Upgrade Guide 文档来参考 Confluence 如何一步一步的在你的系统上进行安装。
4. 下载和安装 Oracle thin 驱动
基于许可证的考虑,我们不能将 Oracle 的驱动捆绑到 Confluence 中。如果你希望你的 Confluence 能够连接到 Oracle 数据库,你需要:
- 停止 Confluence。
- 进入 Database JDBC Drivers 页面然后下载正确的驱动。驱动通常被命名为 ojdbc8.jar。
- 将下载的 .jar 文件放置到你的
<installation-directory>/confluence/WEB-INF/lib
目录中。 - 重新启动 Confluence,然后使用浏览器访问
http://localhost:<port>
然后按照提示进行下一步的操作。
5. 输入你的数据库细节
Confluence 的安装向导将会指导你一步一步的在 Confluence 中配置安装 Oracle 数据库。
使用 JDBC 连接(默认)
JDBC 是推荐的连接你的 Confluence 到数据库中的方式。
Confluence 的安装向导将会提供给你下面 2 种连接选项:
- 简单 —— 这个是最简单的方式来连接你的 Confluence 到数据库中。
- 通过连接字符串 —— 使用这个选项,你需要配置特定的参数同时你还需要具有数据库连接方面的一些只是来构建正确的连接 URL。
基于你设置的类型,你需要提供下面的一些参数。
设置类型 | 字段 | 描述 |
---|---|---|
简单(Simple) | 主机名(Hostname) | 你数据库服务器使用的主机名或者 IP 地址。 |
简单(Simple) | 端口( Port) | Oracle 服务器的端口,如果你在安装的时候没有修改 Oracle 服务器的端口的话,默认情况下 Oracle 使用 1521 端口。 |
简单(Simple) | 服务名(Service name) | 你 Confluence 数据库使用的服务名称。 |
通过连接字符串(By connection string) | 数据库 URL(Database URL) | 数据库的 URL 使用下面的格式: <SERVICE> 可以是 SID 或者是服务名。例如: 在默认的情况下,新的 URL 样式使用 thin 驱动提供,你同时还需要制定 |
同时需要(Both) | 用户名(Username) | 你连接数据库需要使用的用户名,在上面的示例中,用户名是 confluenceuser 。 |
同时需要(Both) | 用户密码(Password) | 你连接数据库需要使用的用户名密码。 |
使用 JNDI 数据源
如果你希望使用 JDNI数据源,请参考 Configuring a datasource connection 中的内容来进行配置。你需要在启动 Confluence 之前进行配置,在设置向导中,Confluence 只使用在你 Tomcat 配置中提供的选项。
6. 测试你的数据库连接
在你的数据库设置界面,有一个 测试连接(Test connection)按钮可以检查:
- Confluence 可以连接你的数据库服务器
- 数据库的字符集编码是否正确
- 你的数据库用户是否具有需要的权限
- 你的数据库用户没有赋予 SELECT ANY TABLE 权限
一旦上面的测试成功了,单击 下一步(Next )来继续进行 Confluence 的安装进程。
问题解决
- 如果 Confluence 提示没有 class 文件,你可能将你的 JDBC 驱动放置到了错误的文件夹。
- 下面的页面包含了一些你在使用 Oracle 数据库连接的时候可能会遇到的常见问题,请参考: Known Issues for Oracle。