はじめに
久しぶりにMattermostをインストールしようと思ったら色々と変わっていたので、インストール方法をメモることにした。
対象環境
OS:Rocky Linux 8.5
準備
Rocky Linuxは基本的にデフォルト状態でインストールし、以下の作業を実施済み。
# dnf update
# dnf install epel-release
# dnf install elrepo-release
mariadb インストール
mariadb をインストールします。
# dnf install mariadb-server
# systemctl start mariadb
# systemctl enable mariadb
# mysql_secure_installation
DB作成
こちらもザクっと書いちゃいます。
# mysql -u root -p
Enter password :
Welcome to the MariaDB monitor . Commands end with ; or \ g .
Your MariaDB connection id is 17
Server version : 10.3.32 - MariaDB MariaDB Server
Copyright ( c ) 2000 , 2018 , Oracle , MariaDB Corporation Ab and others .
Type 'help;' or '\h' for help . Type '\c' to clear the current input statement .
MariaDB & #91;(none)]> create user 'mmuser'@'%' identified by 'xxxxxx';
MariaDB & #91;(none)]> create database mattermost;
MariaDB & #91;(none)]> grant all privileges on mattermost.* to 'mmuser'@'%';
ザクっと行き過ぎ？
Mattermost ダウンロード
なんでこのメモ。。。記事を書き始めたかというと、コレなんです！
やりたいことは、インストールモジュールをダウンロードしたいのですが、どこにあるか分からなかった。
準備が出来たので、ダウンロード対象を探します。https://mattermost.com/deploy/
https://mattermost.com/deploy/ 下の方にスクロールすると、こんな画面があるので、「Binary」タブを選択する。
Docker用 すると、こんな画面になる。
Binary Download URLをコピって、以下のコマンドを実行する。
# wget https://releases.mattermost.com/6.7.0/mattermost-6.7.0-linux-amd64.tar.gz
※バージョン番号はダウンロードするタイミングで変わっていると思われるので注意してください。
せっかくなので、先のホームページで「Installation Guide >> 」とその後の手順が示されているっぽいので覗いてみます。
インストールガイド どっかの（ここも含めて）サイトの内容を信じるよりも、インストールガイドに従って作業を進める方が確実ですね♪
Mattermost インストール
インストールガイドに書かれている内容を素直に信じて作業を進めます！
さて、進めます。
# tar -xvzf mattermost*.gz
本体を移動します。
ストレージディレクトリを作成します。
# mkdir /opt/mattermost/data
※ストレージディレクトリには、ユーザーがMattermostに投稿するすべてのファイルと画像が含まれるため、アップロードされるファイルと画像の予想数を保持するのに十分な大きさのドライブがあることを確認する必要があります。
いざとなったら、シンボリックリンクで余裕のあるディレクトリへ保存することも考えた方が良いかも知れませんね。
ここまでで本体のインストールは一旦終わったようです。
Mattermost セッティング
mattermostのサービスを実行するために、ユーザとグループを作成し所有権と権限を設定します。
# useradd --system --user-group mattermost
# chown -R mattermost:mattermost /opt/mattermost
# chmod -R g+w /opt/mattermost
よく失敗する私は、設定ファイルを変更する前にバックアップを作成します。
# cd /opt/mattermost/config/
# cp -p config.json config.json_org
設定ファイルを弄って動かなくなって、後戻りできなくなってしまうことがよくあるのでやっているだけで、自信のある人はそんなことしないで進んでください。
設定ファイルを編集します。
滅茶苦茶余談ですが。。。。jqというjsonを扱うコマンドがあります。
変更内容は以下の通りです。
SqlSetteings -> DriverName を”mysql”に変更 SqlSetteings -> DataSource を “mmuser:<mmuser-password>@tcp(<host-name-or-IP>:3306)/mattermost?charset=utf8mb4,utf8&writeTimeout=30s" <mmuser-password>はDBユーザ作成時に設定したパスワードを指定してください。
実際のサンプルを以下に記します。
"SqlSettings" : {
"DriverName" : "mysql" ,
"DataSource" : "mmuser:xxxxxx@tcp(localhost:3306)/mattermost?charset=utf8mb4,utf8\u0026writeTimeout=30s" ,
起動確認
本番起動を行う前に、正しく起動できるか確認してみます。
# cd /opt/mattermost
# sudo -u mattermost bin/mattermost
ごちゃごちゃとログが出力されます。
環境が許すのであれば、firewalldをストップさせて確認しようと思います。
# systemctl stop firewalld
この後、以下のURLをブラウザで起動して確認してみます。
http://localhost:8065/
サインアップ用の画面が表示されればなんとなく安心できます。
firewalldの設定
標準の環境だと、当然firewalldが動作していて、対象のポートはアクセスできません。
取り敢えず、一旦は8065ポートを解放してアクセスできることを確認します。
先程、firewallldを止めてしまった場合には以下のコマンドで再起動しておきます。
# systemctl start firewalld
以下のコマンドで8065ポートを解放します。
# firewall-cmd --add-port=8065/tcp --permanent
# firewall-cmd --reload
再度ブラウザでアクセスすると正常にアクセスできることを確認できるとおもいます。
systemdによる自動起動設定
「起動確認」で起動したmattermostはCTRL＋Cで終了させます。
systemdによる自動起動の設定を行います。
まず、serviceファイルを作成します。
# touch /lib/systemd/system/mattermost.service
# cd /lib/systemd/system/
# vi mattermost.service
記載内容は以下の通りです。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
& #91;Unit]
Description = Mattermost
After = network . target
After = mariadb . service
BindsTo = mariadb . service
& #91;Service]
Type = notify
ExecStart = / opt / mattermost / bin / mattermost
TimeoutStartSec = 3600
KillMode = mixed
Restart = always
RestartSec = 10
WorkingDirectory = / opt / mattermost
User = mattermost
Group = mattermost
LimitNOFILE = 49152
& #91;Install]
WantedBy = multi - user . target
[Unit]セクションのAfterとBindsToの項目をmariadb.serviceに変更しています。
それでは起動してみましょう！
# systemctl daemon-reload
# systemctl start mattermost.service
Job for mattermost . service failed because the control process exited with error code .
See "systemctl status mattermost.service" and "journalctl -xe" for details .
いきなり失敗しました！
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# journalctl -xe
-- Defined - By : systemd
-- Support : https : //lists.freedesktop.org/mailman/listinfo/systemd-devel
--
-- Unit mattermost . service has failed .
--
-- The result is failed .
5 月 28 06 : 07 : 39 localhost . localdomain setroubleshoot & #91;14220]: AnalyzeThread.run(): Cancel pending alarm
5 月 28 06 : 07 : 39 localhost . localdomain setroubleshoot & #91;14220]: <code>SELinux is preventing /usr/lib/systemd/systemd from execute access on</code> t>
5 月 28 06 : 07 : 39 localhost . localdomain setroubleshoot & #91;14220]: SELinux is preventing /usr/lib/systemd/systemd from execute access on t>
* * * * * Plugin catchall ( 100. confidence ) suggests * * * * * * * * * * * * * * * * * * & gt ;
If you believe that systemd should be allowed execute access on the ma & gt ;
Then you should report this as a bug .
You can generate a local policy module to allow this access .
Do
allow this access for now by executing :
# ausearch -c '(ttermost)' --raw | audit2allow -M my-ttermost
# semodule -X 300 -i my-ttermost.pp
5 月 28 06 : 07 : 39 localhost . localdomain setroubleshoot & #91;14220]: AnalyzeThread.run(): Set alarm timeout to 10
5 月 28 06 : 07 : 42 localhost . localdomain org . gnome . Shell . desktop & #91;6472]: Window manager warning: last_user_time (10454099) is greater th>
5 月 28 06 : 07 : 42 localhost . localdomain org . gnome . Shell . desktop & #91;6472]: Window manager warning: W3 appears to be one of the offending w>
まあ、ざっくりと言うと、SELinuxのチェックに引っ掛かって止まっています。
取り敢えず、表示された内容に記載されているコマンドを打ち込んで対応を行います。
適当なディレクトリに移動してから以下のコマンドを実行します。
# ausearch -c '(ttermost)' --raw | audit2allow -M my-ttermost
# semodule -X 300 -i my-ttermost.pp
再度実行してみますが。。。。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# systemctl start mattermost
Job for mattermost . service failed because the control process exited with error code .
See "systemctl status mattermost.service" and "journalctl -xe" for details .
& #91;root@localhost ~]# journalctl -xe
5 月 28 06 : 15 : 58 localhost . localdomain dbus - daemon & #91;934]: [system] Successfully activated service 'org.fedoraproject.SetroubleshootPrivileged'
5 月 28 06 : 15 : 59 localhost . localdomain setroubleshoot & #91;15253]: SELinux is preventing /usr/lib/systemd/systemd from 'read, open' accesses on the file /opt/mattermost/bin/mattermost. For complete SELinux >
5 月 28 06 : 15 : 59 localhost . localdomain setroubleshoot & #91;15253]: SELinux is preventing /usr/lib/systemd/systemd from 'read, open' accesses on the file /opt/mattermost/bin/mattermost.
* * * * * Plugin restorecon ( 99.5 confidence ) suggests * * * * * * * * * * * * * * * * * * * * * * * *
If you want to fix the label .
/ opt / mattermost / bin / mattermost default label should be bin_t .
Then you can run restorecon . The access attempt may have been stopped due to insufficient permissions to access a parent directory in whic & gt ;
Do
# /sbin/restorecon -v /opt/mattermost/bin/mattermost
* * * * * Plugin catchall ( 1.49 confidence ) suggests * * * * * * * * * * * * * * * * * * * * * * * * * *
If you believe that systemd should be allowed read open access on the mattermost file by default .
Then you should report this as a bug .
You can generate a local policy module to allow this access .
Do
allow this access for now by executing :
# ausearch -c '(ttermost)' --raw | audit2allow -M my-ttermost
# semodule -X 300 -i my-ttermost.pp
またしてもエラーが発生して留まってしまいます。
# /sbin/restorecon -v /opt/mattermost/bin/mattermost
あれ？返ってこない。。。長い。。。という状態が続きます。
コマンドの終了を待って実行します。
# systemctl start mattermost.service
今度は成功した様です。
# systemctl status mattermost.service
● mattermost . service - Mattermost
Loaded : loaded ( / usr / lib / systemd / system / mattermost . service ; disabled ; vendor preset : disabled )
Active : active ( running ) since Sat 2022 - 05 - 28 06 : 17 : 38 JST ; 19s ago
Main PID : 15595 ( mattermost )
Tasks : 40 ( limit : 4605 )
Memory : 99.4M
CGroup : / system . slice / mattermost . service
├─15595 / opt / mattermost / bin / mattermost
├─15616 plugins / com . mattermost . nps / server / dist / plugin - linux - amd64
├─15624 plugins / com . mattermost . plugin - channel - export / server / dist / plugin - linux - amd64
├─15638 plugins / playbooks / server / dist / plugin - linux - amd64
└─15646 plugins / focalboard / server / dist / plugin - linux - amd64
最後に自動起動を設定します。
# systemctl enable mattermost.service
以上でMattermostのインストールと設定は完了しました。
ここから実際にチームを作成して利用できる環境設定を行います。
http://ドメイン:8065/
ログイン完了後に幾つかの設定を行いますので、その設定については別途記載したいと思います。
