Tigase:用GUI安装包安装
(→开始安装) |
|||
| （未显示1个用户的6个中间版本） | |||
| 第1行： | 第1行： | ||
[[Category:XMPP服务器文档]] | [[Category:XMPP服务器文档]] | ||
| − | [[Category: | + | [[Category:已翻译]] |
'''本文的英文原文来自 http://www.tigase.org/content/installation-using-gui-installer ''' | '''本文的英文原文来自 http://www.tigase.org/content/installation-using-gui-installer ''' | ||
| 第76行： | 第76行： | ||
http://www.tigase.org/files/image/gui-install/winInstall13Mini(3).gif | http://www.tigase.org/files/image/gui-install/winInstall13Mini(3).gif | ||
| + | |||
| + | 在这个屏幕你将找到重要的基本配置选项. 本指南只涉及非高级的设置 - 禁止高级配置选项. | ||
| + | |||
| + | 你可以选择安装哪些组件. 对于大部分安装来说缺省的选择是最适合的. 你可以展开这个列表来检查是否有任何其他选项更加满足你的需要. | ||
| + | |||
| + | 对你来说在这正确地输入你的域名是非常重要的. | ||
| + | |||
| + | :* 在类 '''Linux''' 系统中你可以使用 '''hostname''' 命令并从输出结果中提取出域部分. 如果你使用 '''-f''' 参数，那么你将获得完整的合格域名. | ||
| + | :* 在 '''Windows''' 中使用标准 '''系统''' 控制台applet. 你将在 '''电脑名''' tab找到你的域名(电脑名). | ||
| + | |||
| + | 另一方面如果你想使用Tigase的虚拟域支持，你要正确地配置你的 '''DNS''' 系统, 接着你可以在这里放你的虚拟域列表. 就用逗号把它们分开. 例如如果你的服务器从外部看是 '''veloci.tigase.org, mammoth.tigase.org''' 和 '''tigase.org''' ,然后你可以如同有三个分开的实例那样使用Tigase实例. 实际上它是一台服务器, 无论如何 '''admin@veloci.tigase.org''' 和 '''admin@tigase.org''' 将是不同的用户. 这个特性允许使用一个服务器用于分开的用户群体, 例如不同的组织. | ||
| + | |||
| + | 现在你要把域名填到 域 文本框里. 下一个参数是服务器管理员的JID. 标准做法是给把它的名字设为 '''admin''' , 无论如何你可以选择任何你喜欢的名字. 例如对于域 '''tigase.org''' 完整的 admin 名称将是 '''admin@tigase.org''' . 把你选择的名称和域名连在一起，使用 @ 符号做分隔符. | ||
| + | |||
| + | 从这个版本开始你的 XMPP admin 将被自动添加到数据库, 所以在安装之后你可以不用手工注册admin就登陆到服务器了. | ||
| + | |||
| + | 你也应该选择一个数据库用于存储你的用户信息. 缺省的是 '''Derby''' 数据库, 如果你不需要任何特别的东西就保持那个配置. 选择一个新密码，因为缺省的密码可能很容易被黑客猜到. | ||
| + | |||
| + | '''重要通知: Tigase安装包不包含实际的数据库, 只有允许db访问的驱动. 一个例外是Derby数据库, 它被包含在JDK中. 这是由安装包自动配置的, 在使用其他数据库的情况下你将需要自己配置它们''' . | ||
| + | |||
| + | ===数据库连接检查和执行DB任务=== | ||
| + | |||
| + | http://www.tigase.org/files/image/gui-install/winInstall20Mini(1).gif | ||
| + | |||
| + | 当你切换到这个屏幕的时候将启动一个数据库配置的自动测试. 它包括几个顺序执行的步骤. 在测试连接和配置schema之后, admin 用户将被添加. | ||
| + | |||
| + | 如果测试失败该干什么? | ||
| + | |||
| + | :* 如果你决定使用你自己的数据库, 检查是否你输入了正确的密码和是否你的数据库在运行中. | ||
| + | :* 如果你使用内置的 '''Derby''' 数据库，那么可能你的问题更加复杂. 安装包的一个错误可能指出一个bug. 你可以把它汇报给Tigase开发者之一. | ||
| + | |||
| + | 如果在解决了数据库问题之后你还不能度过这一步，你可以尝试手工安装模式. | ||
| + | |||
| + | ==完成安装== | ||
| + | |||
| + | 当你执行了所有那些步骤包括选择开始菜单位置以及其他基本动作，你将被通知安装过程已经完成了. 现在你可以使用你的Tigase服务器了. 可能有一些安装之后的动作你想去做. 它们主要如下所示. | ||
| + | |||
| + | ==运行服务器== | ||
| + | |||
| + | 安装过程的一部分是Tigase根目录的选择. 在这里你能找到所有重要的服务器文件. 安装包将在 '''开始''' 菜单创建一些可配置的快捷方式. 你可以在菜单中浏览并使用它来启动服务器. 如果要手工运行服务器: | ||
| + | |||
| + | :* 在一个 '''Linux''' 系统你可以使用Tigase服务器根目录下的 '''scripts''' 子目录里的 '''tigase.sh''' 文件启动服务器. 在根服务器目录输入以下命令: | ||
| + | <source lang="bash"> | ||
| + | ./scripts/tigase.sh start etc/tigase.conf | ||
| + | </source> | ||
| + | :* 当然如果你有定制的配置文件，那么可以适当修改上一个命令. | ||
| + | :* 在一个 '''Windows''' 平台你可以使用一个 '''bat''' 文件来运行服务器. 在Tigase根目录有一个 '''run.bat''' 文件. 只要在 '''文件浏览器'''双击它或从命令行运行它来启动服务器. 一个服务器日志输出的窗口将弹出来. | ||
| + | |||
| + | http://www.tigase.org/files/image/gui-install/winRunMini.gif | ||
| + | |||
| + | ==安装成一个服务== | ||
| + | |||
| + | 在 '''Windows''' 下你可以把Tigase安装成一个服务. 要做到这一点，使用在服务器根目录找到的 '''InstallTigaseService.bat''' 批处理文件. | ||
| + | |||
| + | 在这个模式下服务将被运行在后台并且将可以从 '''服务''' 管理控制台来控制. 要打开这个工具，右击桌面上 '''我的电脑''' 图标. 选择 '''管理''' 动作. 这将运行 '''计算机管理''' 图形化配置程序. 在左边选择 '''服务''' 条目. 你将看大一个服务列表. 这里你可以找到Tigase服务，如果它已经装好的话. | ||
| + | |||
| + | 要卸载Tigase服务，使用Tigase服务器根目录的 '''UninstallTigaseService.bat''' . | ||
| + | |||
| + | ==如何检查服务器是否正在运行== | ||
| + | |||
| + | 检查服务器是否正在运行是很容易的. 只要使用可用的XMPP客户端之一尝试连接它就可以了. | ||
2013年7月31日 (三) 06:07的最后版本
本文的英文原文来自 http://www.tigase.org/content/installation-using-gui-installer
如果你不想使用手动方式来安装Tigase, 你可以使用GUI安装包. 它不只拷贝服务器文件到首选的位置, 而且辅助配置大部分参数和数据库设置. 所以它安装Tigase的首选方式.
目录 |
前提条件
在你能够启动GUI安装包之前，你将需要一个Java工作环境. 尽管安装包只要求 JRE (Java运行时环境), 服务器需要 JDK (Java开发包). 请注意目前 Tigase可以运行的的最低JDK版本是1.6 . 如果你还没有安装JDK，现在该装上它了. 访问 Java下载网站, 从可用的包列表中选择最新的JDK版本(如果你没有使用J2EE的特别需求，那么选择一个不带它的包). 在配置了JDK之后你可以下载 Tigase GUI安装包并开始服务器安装过程. 把 JAVA_HOME 环境设置正确也是非常重要的.
下载安装包
你总是能在下载章节找到最新的Tigase包. 当你进入该页面, 你将看到一个可选的文件列表. 开始你可能很疑惑有太多选择, 但是你不需要担心. 所有Tigase二进制包都有约定的名称, 这帮助你很容易地区分它们. 它们的格式是 tigase-server-x.y.z-bv.ext ，这里 'x', 'y', 'z' 和 'v' 是版本号并且它们的变更是从每一次发布. Ext 是文件扩展名，这里我们的GUI安装包程序是 .jar . 我们推荐你下载该服务器的最新版本(最高的版本号)，因为它包含了最新的功能和提升.
运行jar文件
在大部分系统中安装了JRE或JDK之后会创建缺省的文件关联以允许运行 .jar 文件，通过 点击/双击 它. 无论如何如果当你点的时候什么都没发生你可以手工执行它. 按顺序执行以下步骤:
1. 如果你在Windows系统上你可以使用命令行提示方式来使用java命令直接运行安装包.
- 点击 开始 菜单并选择 运行 操作(你也可以使用 Win + R 快捷方式).
- 你将看到一个对话框，这里你可以输入一条命令. 键入 "cmd" (或 "command" ，在某些2000之前的老的windows版本中) 并提交该窗口.
- 如果你在Linux系统, 你可以使用一个终端. 在这个平台上它是一个标准工具并且很容易找. 找到并运行它.
2. 命令提示 / 终端 将出现. 你将能检查是否你的Java环境在正常工作. 键入以下命令然后回车.
java -version- 如果返回的消息说无法识别该命令那么你的 Java 安装可能是错误的或配置不正确. 为了正确设置 JRE/JDK 包括设定 JAVA_HOME 环境变量，请检查JDK下载网站提供的文档. 如果命令成功了请检查列出来的版本号码满足Tigase的要求. 当一台机器上装了多个版本的 JDK/JRE ，java 命令将需要使用它所在的全路径来调用.
3. 当你毫无疑问你能运行正确的java命令, 你可以启动该安装包. 即被下载到 c:\download 目录的文件 tigase-server-4.1.0-b1315.jar ， 键入以下命令:
java -jar c:\download\tigase-server-4.1.0-b1315.jar
- 这个命令应该启动该安装包或列出一个错误消息来解释出现了什么问题.
开始安装
请注意本教程只涉及基本的安装模式. 一些屏幕被忽略了，因为它们包含在简单安装模式中没有的高级选项. 另一方面其他比如文件拷贝过程和总结信息等自解释的过程也没有描述.
JDK选择
这个屏幕只在JDK没有被自动选择的时候出现. 当你的 JAVA_HOME path 正确的设置了, 它将被自动探测到以节省你的配置时间. 如果你读到这一步而仍然未安装JDK, 那么返回前提条件， 那里你能找到一些关于如何为Tigase安装准备你的系统的信息. 有时你的系统将被配置成阻止探测JDK路径. 这经常发生你在安装了JDK之后再安装JRE的情况下. 你将不得不自己去找JDK目录. 它的缺省安装位置在你的系统驱动盘的 Program Files\Java 目录.
安装类型选择
推荐的实践是同时选择安装和配置服务器，因为手动配置服务器比较复杂，耗时且易于出错.
介绍服务器
这个屏幕显示一些关于Tigase的信息，帮助你理解它是什么以及如何帮你获得XMPP协议的好处. 阅读安装包上出现的所有信息是很重要的, 因为它们包含了有价值的建议和大部分最近的信息.
选择程序根目录
在这个点你选择你希望你的服务器装到哪. 推荐的路径应该不包含空格, 因为它可能导致一些未知的路径问题. 在Windows的安装场景下它应该被安装到一个短路径，因为路径长度有限制. 也要注意在Windows Vista下安装到 Program Files 目录可能会使得服务器的工作发生一些问题, 和UAC机制相关的工作, 所以最好不要安装到那. 如果你拿不定主意想把服务器装到哪, 你总是可以留着缺省值.
包选择
下一个重要步骤是包选择. 一些选择是灰的并且你不能选择它们，因为它们是最基本的. 所有其他的包都是可选的. 它包括 文档, 数据库驱动, 服务器源码 和一些附属项. 当你选择一个条目, 你将看到关于它的内容的简短描述.
我们推荐你安装文档. 它包含了有价值的资源，非常有助于服务器的管理和常规使用.
如果你有一个工作着的数据库平台，你想用它来存储所有重要用户信息, 就选择适当的db驱动. 如果你没有一个数据库引擎, 你可以使用内置的derby，它的驱动也已经内置了.
如果你是一个开发者并且你想能检查该服务器如何工作或你想帮助开发, 你也可以安装被包含的源码.
基本的服务器配置
.gif)
在这个屏幕你将找到重要的基本配置选项. 本指南只涉及非高级的设置 - 禁止高级配置选项.
你可以选择安装哪些组件. 对于大部分安装来说缺省的选择是最适合的. 你可以展开这个列表来检查是否有任何其他选项更加满足你的需要.
对你来说在这正确地输入你的域名是非常重要的.
- 在类 Linux 系统中你可以使用 hostname 命令并从输出结果中提取出域部分. 如果你使用 -f 参数，那么你将获得完整的合格域名.
- 在 Windows 中使用标准 系统 控制台applet. 你将在 电脑名 tab找到你的域名(电脑名).
另一方面如果你想使用Tigase的虚拟域支持，你要正确地配置你的 DNS 系统, 接着你可以在这里放你的虚拟域列表. 就用逗号把它们分开. 例如如果你的服务器从外部看是 veloci.tigase.org, mammoth.tigase.org 和 tigase.org ,然后你可以如同有三个分开的实例那样使用Tigase实例. 实际上它是一台服务器, 无论如何 admin@veloci.tigase.org 和 admin@tigase.org 将是不同的用户. 这个特性允许使用一个服务器用于分开的用户群体, 例如不同的组织.
现在你要把域名填到 域 文本框里. 下一个参数是服务器管理员的JID. 标准做法是给把它的名字设为 admin , 无论如何你可以选择任何你喜欢的名字. 例如对于域 tigase.org 完整的 admin 名称将是 admin@tigase.org . 把你选择的名称和域名连在一起，使用 @ 符号做分隔符.
从这个版本开始你的 XMPP admin 将被自动添加到数据库, 所以在安装之后你可以不用手工注册admin就登陆到服务器了.
你也应该选择一个数据库用于存储你的用户信息. 缺省的是 Derby 数据库, 如果你不需要任何特别的东西就保持那个配置. 选择一个新密码，因为缺省的密码可能很容易被黑客猜到.
重要通知: Tigase安装包不包含实际的数据库, 只有允许db访问的驱动. 一个例外是Derby数据库, 它被包含在JDK中. 这是由安装包自动配置的, 在使用其他数据库的情况下你将需要自己配置它们 .
数据库连接检查和执行DB任务
.gif)
当你切换到这个屏幕的时候将启动一个数据库配置的自动测试. 它包括几个顺序执行的步骤. 在测试连接和配置schema之后, admin 用户将被添加.
如果测试失败该干什么?
- 如果你决定使用你自己的数据库, 检查是否你输入了正确的密码和是否你的数据库在运行中.
- 如果你使用内置的 Derby 数据库，那么可能你的问题更加复杂. 安装包的一个错误可能指出一个bug. 你可以把它汇报给Tigase开发者之一.
如果在解决了数据库问题之后你还不能度过这一步，你可以尝试手工安装模式.
完成安装
当你执行了所有那些步骤包括选择开始菜单位置以及其他基本动作，你将被通知安装过程已经完成了. 现在你可以使用你的Tigase服务器了. 可能有一些安装之后的动作你想去做. 它们主要如下所示.
运行服务器
安装过程的一部分是Tigase根目录的选择. 在这里你能找到所有重要的服务器文件. 安装包将在 开始 菜单创建一些可配置的快捷方式. 你可以在菜单中浏览并使用它来启动服务器. 如果要手工运行服务器:
- 在一个 Linux 系统你可以使用Tigase服务器根目录下的 scripts 子目录里的 tigase.sh 文件启动服务器. 在根服务器目录输入以下命令:
./scripts/tigase.sh start etc/tigase.conf
- 当然如果你有定制的配置文件，那么可以适当修改上一个命令.
- 在一个 Windows 平台你可以使用一个 bat 文件来运行服务器. 在Tigase根目录有一个 run.bat 文件. 只要在 文件浏览器双击它或从命令行运行它来启动服务器. 一个服务器日志输出的窗口将弹出来.
安装成一个服务
在 Windows 下你可以把Tigase安装成一个服务. 要做到这一点，使用在服务器根目录找到的 InstallTigaseService.bat 批处理文件.
在这个模式下服务将被运行在后台并且将可以从 服务 管理控制台来控制. 要打开这个工具，右击桌面上 我的电脑 图标. 选择 管理 动作. 这将运行 计算机管理 图形化配置程序. 在左边选择 服务 条目. 你将看大一个服务列表. 这里你可以找到Tigase服务，如果它已经装好的话.
要卸载Tigase服务，使用Tigase服务器根目录的 UninstallTigaseService.bat .
如何检查服务器是否正在运行
检查服务器是否正在运行是很容易的. 只要使用可用的XMPP客户端之一尝试连接它就可以了.
