Tigase8.1.2安装配置

tigase版本：8.1.2

官方文档地址：Tigase Administration Guide

安装

参考：Tigase Administration Guide

完全按官方文档安装有一些问题，本人遇到的问题是 HTTP REST SECURITY CONFIGURATION这个选项卡居然没有，这样就导致无法在安装时添加api key。后面又遇到无法登录 http://localhost:8080/admin 界面问题。可见官方文档也还是有点坑。

1. 下载安装包并解压

   https://github.com/tigase/tigase-server/releases/download/tigase-server-8.1.2/tigase-server-8.1.2-b10915-dist-max.tar.gz
   ​
   tar -xf tigase-server-8.1.2-b10915-dist-max.tar.gz
   cd tigase-server-8.1.2-b10915

   启动前检查环境，我选择的这个版本较新，JDK要求在11版本以上，我直接使用JDK11。配置JDK如下

   vi tigase-server-8.1.2-b10915/etc/tigase.conf
   ​
   JAVA_HOME="/usr/lib/jvm/java-11-openjdk-amd64"

   如果是ubuntu上安装的openjdk，可以参考下面的指令找到jdk路径

   kangming@ubuntu:~$ which java
   /usr/bin/java
   kangming@ubuntu:~$ ls -lrt /usr/bin/java
   lrwxrwxrwx 1 root root 22 May 28  2020 /usr/bin/java -> /etc/alternatives/java
   kangming@ubuntu:~$ ls -lrt /etc/alternatives/java
   lrwxrwxrwx 1 root root 43 Feb 24 15:44 /etc/alternatives/java -> /usr/lib/jvm/java-11-openjdk-amd64/bin/java

   启动并查看日志

   scripts/tigase.sh start etc/tigase.conf
   tail -f logs/tigase-console.log

   检测端口监听，确保8080端口在监听即可

   lsof -i -P

   接下来就可以使用web对tigase进行安装了。注意默认配置config.tdsl内容如下，这个配置是初始化tigase时使用的配置，如果想重装，将配置文件重置如下即可。

   'config-type' = 'setup'
   ​
   http () {
       setup () {
           'admin-user' = 'admin'
           'admin-password' = 'tigase'
       }
   }

2. 利用webinstall进行安装

• 初始访问会要求输入账号密码，账号密码就是上面配置显示的admin、tigase。正确登录后会见到如下界面，直接点Next即可。（这个界面和官方文档介绍的对比，少了一项HTTP REST SECURITY CONFIGURATION）

• 第二步输入公司名或个人名字即可

• 第三步，配置domain等信息

这一步在数据库上我使用了mongodb，因为本人的虚拟机主机名为ubuntu，所以domain我就用ubuntu了，这个domain一般要使用公网域名。注意ubuntu域名我是在宿主的hosts文件上手动配置了的。server管理员账号这里设置的格式为 用户名@domain，这步过后，admin这个管理员并没创建到数据库，稍后需要使用web ui界面进行创建。

• 接下来的4，5步直接Netx。下面看第6步

这一步需要填数据库相关配置，数据库管理用户，超管用户、普通账号用户需要提前创建好。此处我的mongodb为社区4.4版本。

• 点击Next，配置正确的话，将看到如下界面，此时tigasedb已创建

• 点击Next进行第8步

这一步设置的管理员账号和密码是为了配置成功后，再次通过http://ubuntu:8080/setup界面对配置进行修改。我这里使用了和服务管理员一样的账号。注意此时这个账号并不会在tig_users上创建，它目前仅仅能访问setup界面。

• 点击Next进行第9步

点击Save保存这个配置文件。然后就可以去服务端重启tigase。

./scripts/tigase.sh stop
​
./scripts/tigase.sh start etc/tigase.conf

到此安装所有步骤完成。此时配置文件内容如下

admins = [
    'admin@ubuntu'
]
'config-type' = 'default'
debug = [ 'server' ]
'default-virtual-host' = 'ubuntu'
dataSource () {
    default () {
        uri = 'mongodb://user:pwd@192.168.43.23:28017/yourdb'
    }
}
http () {
    setup () {
        'admin-password' = 'pwd'
        'admin-user' = 'admin@ubuntu'
    }
}
pubsub () {
    trusted = [ 'http@{clusterNode}' ]
}

配置

• 访问http://ubuntu:8080/会看到如下界面

点击/ui，通过ui，可以创建用户。特别是要创建admin@ubuntu这个管理员，这个用户才可以访问/admin界面。也就是配置文件的admins列表里的用户只是配置了，但tigase并没自动帮我们创建，所以此时你拿admin@ubuntu去登录admin界面是不会成功的。

• 创建账号

访问ui后，点击Register按钮进行用户注册。Domain选择自己的域名即可。点击Next

账号admin 所有在admins列表中的用户都需要创建，否则这个管理员用户是没法用的。

admin管理设置

有了上面创建的admin账号，就可以访问admin管理界面了。

输入账号（用户Jid，即在数据库表tig_users的user_id那列）和密码。正确进入界面如下

如果使用一个不是在管理员列表里的用户登录这个界面，是看不到左边的配置项目的。此管理配置界面的使用参考文档：Tigase Administration Guide

管理用户

创建用户

注意这里创建用户是直接填JID。

配置API-KEY

填一下域名提交即可，2b3e5f9c-c1d7-4c8e-bcdd-845cfb6a789b这串key是自动生成的，也可以自己填一个。

配置成功后将在tig_nodes表中产生key为api-keys的记录。