快速入门

页面树结构

运行Confluence 设置向导之前，请先浏览 Confluence 安装与升级指南。

当你第一次通过网页浏览器访问Confluence时，你会看到 Confluence 设置向导 页面。 提示你设置Confluence站点的默认值。 设置向导也会提供一些数据连接的高级选项,也可以帮助你从先前的备份恢复重要的数据。

本页面内容:

1. 运行设置向导

  1. 如果 Confluence 还没有运行, 你需要启动Confluence:
    • 如果你在Windows上运行 Confluence Standalone , 点击 '开始'..., '程序'..., 'Atlassian Confluence'..., 'Start in Console'.
    • 如果您在MAC 上运行 Confluence Standalone , 点击 '应用程序'..., 'Atlassian Confluence'.
    • 或者运行安装路径下 bin文件夹中的启动脚本:
      • Windows: startup.bat
      • Unix/Linux : startup.sh
      • Mac OS X 用户会被提示选择一个应用程序。选择Utilities文件夹下的 Terminal 。
  2. 在网页浏览器中输入Confluence地址: http://localhost:8080
    上面网页地址中使用的是 '8080' 端口。 如果你在安装时设置了其他端口, 你需要将 '8080' 改成正确的端口号。
    • 你会看到下面所描述的授权信息页面。
    • 如果出现了错误信息, 请先检查使用的端口号是否正确。然后再参考 Installation FAQ.

2. 输入授权码

截图: 授权信息及安装类型

将Confluence授权码粘贴到 'License Key' 字段, 就像上面截图。

如果你已经申请了授权码, 你可以从 Atlassian 网站 获取。

如果你还没有申请 Confluence 授权码, 你可以马上获得:

  • 取得免费试用授权码:
    1. 在设置向导页面点击 'generate an evaluation license online'，参见上面截图。
    2. 根据提示生成授权码，并自动粘贴到设置向导页面的授权码字段。
  • 要获得商业授权, 教育机构授权, 非盈利组织授权或开源组织授权:
    1. 请与Atlassian合作伙伴联系。

3. 选择安装类型

这个步骤, 你需要选择试用安装或是正式生产环境安装。

选项 1: Evaluation Installation — 使用Confluence 内置的 HSQLDB 数据库 以及默认设置选项。 这种安装类型也会安装一个包含示例的 '演示空间'，可以帮助你尽快掌握Confluence。 你也可以日后升级到其他安装类型。

谁需要选择这种安装类型?

  • 如果你出于试用目的，你需要选择这个选项。
  • 如果出于正式使用目的，我们不建议你选择这个选项。

如果为了正式生产环境使用Confluence, 我们强烈建议你使用外部数据库而不要使用内置的HSQL数据库。 试用安装环境不适用于正式生产环境。

 

(信息) 下一步, 你需要设置系统管理员的详细信息。 跳转到 第8步。 你可以跳过下面的步骤 (微笑)

选项 2: Production Installation — 使用独立的数据库并自定义Confluence实例。

正式生产环境安装类型提供下面可选项:

  • 让 Confluence 使用外部数据库。 推荐正式生产环境的Confluence使用这个安装类型。
  • 从现有的Confluence数据库恢复数据。
  • 可以不安装演示内容。

4. 正式环境安装: 配置数据库

截图: 配置数据库

如果你选择了正式生产环境安装类型，你就会看到这个页面。你可以选择安装内置的数据库的Confluence，或使用外部数据库。

  • 选项 1: Embedded Database — 如果你选择了这个选项, Confluence 就会使用内置的 HSQLDB 数据库。 只有当你准备 试用 或 演示 Confluence时才应该选择这个选项。
    (滴答) 你可以日后将这种安装方式的数据迁移到外部数据库。 

  • 选项 2: External Database — 如果你希望 Confluence 使用外部数据库, 请从数据库列表中选择希望使用的数据库类型，并单击 'External Database' 按钮。
    (警告) 如果用于正式生产环境, 你 只能使用 外部数据库，以保证数据安全。 
    (滴答) Confluence支持的平台 中介绍了Confluence可以使用的数据库类型。更多关于外部数据库的详细内容，可以浏览 Confluence基本配置需求。

5. 正式环境安装: 外部数据库

开始之前

  • 字符编码:
    • 我们强烈建议数据库、应用服务器和网页应用程序的字符编码保持一致, 并且使用 UTF-8 编码。
    • 在开始设置数据库之前, 请先阅读 configuring character encoding。
  • 数据库名称: 当创建一个新的外部数据库时, 给数据库命名为 'confluence'。

你可以选择通过标准JDBC链接或通过服务器数据源链接配置数据库。请选择下面选项中的一种方式。

选项 1: Standard Database Connection — 用于标准的JDBC 数据库连接串。 连接池在Confluence中处理。

截图: 标准 (JDBC) 连接

请提供下面的信息:

  • Driver Class Name — 数据库驱动的Java 类名。 这取决于 JDBC 驱动, 并且可以在数据库文档中找到说明。 你还需要将数据库驱动 'jar' 文件存放在服务器的类路径下。 对于Standalone 版本, 就是将jar文件复制到 <confluence-install>/lib 路径。
  • Database URL — 连接数据库的 JDBC URL。 这取决于 JDBC 驱动, 。
  • User Name — Confluence使用这个用户名访问数据库。
  • Password — 上面用户名访问数据库的密码。 

你还需要了解:

  • Confluence需要维护的连接池的大小。如果不清楚, 只需使用默认值。
  • 你要连接的数据库类型, 这样你才能让 Confluence 指导使用何种语言使用你选择的数据库。

选项2: Datasource Connection — Java应用服务器请求的数据库链接。 你需要在应用服务器中配置数据源。

截图: 数据源配置

提供下面的信息:

  • Datasource Name — 数据源的 JNDI 名称, 这个名称必须已经在应用服务器中定义。
    注意: 一些服务器使用的 JNDI 名称类似 jdbc/datasourcename; 而另一些则类似 java:comp/env/jdbc/datasourcename. 请参阅你使用的应用服务器文档。 

你需要了解:

  • 你要连接的数据库类型, 这样你才能让 Confluence 指导使用何种语言使用你选择的数据库。

6. 生产环境安装: 加载内容

截图: 加载内容

选择下面一种选项:

  • Example Site — 这个选项将加载Confluence的 '演示空间'。 如果你第一次使用Confluence， 或者你希望让其他Confluence用户从这个演示空间中学习如何使用Confluence，请选择这个选项。 演示空间帮助你熟悉Confluence并且让你了解Confluence可以为你做些什么。 你可以按照正常步骤继续部署Confluence实例 — 日后不需要重新安装。
  • Empty Site — 如果你非常熟悉怎样使用Confluence，可以选择这个选项。。在为Confluence添加内容之前，你需要至少创建一个空间。
  • Restore from Backup — 如果你希望从先前的备份文件恢复数据，请选择此选项。

7. 正式环境安装: 从备份文件中恢复数据

截图: 恢复数据

这个选项允许你在安装过程中将已有的Confluence数据迁移到新的Confluence实例中。 你可以选择从压缩的备份文件中恢复，或直接从备份文件中恢复。

选项 1: Upload a zipped backup to Confluence — 这个选项将加载压缩的备份文件。
(滴答) 要创建Confluence备份文件，从 站点管理 中选择 备份&恢复 链接。

要恢复一个压缩的备份:

  1. 找到日备份文件或通过 手动备份 的文件。
  2. 选中 'Build Index' 来重建用于搜索的索引。
  3. 点击 'Upload and Restore' 按钮。

选项 2: Restore a backup from the filesystem — 这个选项This option is recommended if you have a very large daily backup file (greater than 100MB), or a daily backup file that is already on the server and doesn't require uploading.

  1. 将备份文件复制到 confluence Home directory 下的 restore 路径并刷新这个页面。 你会看到备份文件出现在 'Restore Data' 页面 'Restore a backup from the filesystem' 标题下方的文本框中。
  2. 选中 'Build Index' 重建搜索索引。
  3. 点击 'Restore' 按钮。

(信息) 当恢复操作结束, 你就可以登录 Confluence。 系统管理员账号和所有其他信息就会从先前的Confluence备份中恢复。

8. 输入Confluence系统管理员的详细信息

截图: 系统管理员

系统管理员 是Confluence实例中具有管理权限的用户。 系统管理员可以添加用户,创建空间并且设置更多的Confluence选项。 请阅读 overview of global permissions 获得更多信息。

提示: 如果你正在试用 Confluence, 请将你自己设置为管理员。

 
  1. 填写下面信息来设置系统管理员账号:
    • Username — Confluence的系统管理员登录账号, 例如 'jsmith'。
    • Password — 系统管理员的登录密码。
    • Confirm — 再次输入一次登录密码。
    • Name — 系统管理员的全称, 例如 'John Smith'.
    • Email — 系统管理员的邮件地址, 例如 'jsmith@example.com'.
  2. 点击 'Next'。

9. 配置完成

Screenshot above: 配置完成

祝贺你! 你已经完成了Confluence的安装和配置工作。 点击 'Start using Confluence now' 链接打开Confluence的 '演示空间' 。 这个空间包含了一些示例和使用提示, 帮助你快速使用Confluence。

  • 无标签