Tigase8.1.2安装配置

tigase版本：8.1.2

官方文档地址：Tigase Administration Guide

安装

参考：Tigase Administration Guide

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

下载安装包并解压

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'}
}

利用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界面对配置进行修改。我这里使用了和服务管理员一样的账号，密码123456。注意此时这个账号并不会在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://euht:nu656@192.168.43.23:28017/tigasedb'}
}
http () {setup () {'admin-password' = '123456''admin-user' = 'admin@ubuntu'}
}
pubsub () {trusted = [ 'http@{clusterNode}' ]
}

配置

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

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

创建账号

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

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

admin管理设置

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

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

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

管理用户

创建用户

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

配置API-KEY

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

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