BaseX (2) / Servlet としての deploy

BaseX のサービス化

BaseX はデータベースであるためサービスとして運用しておきたいという希望があります． サービスとして常時起動させておくための方法には幾つかありますが，自分の運用環境には Tomcat が導入されており，様々な Servlet を導入しています． BaseX も Servlet としてのモジュール化がなされているため， Tomcat 上での Servlet として起動したく思います．

BaseX war のダウンロード

Ubuntu上では apt install basex で標準の BaseX を導入可能ですが， せっかく Tomcat 上で起動・管理することもあり，最新の BaseX を導入したく思います．

Servlet のモジュールとなる warファイル は BaseX のダウンロードサイト から入手可能です．

このページの一番右にある Web Archive と書かれたものが該当の Servlet となります． 僕がダウンロードした際の最新は画面の通り 9.2.2 です．

Tomcat上でのデプロイ

ダウンロードした BaseX の war ファイルをデプロイするのは TomcatのManager画面からするのが楽です． 直接 Tomcat のインストールディレクトリ下にある webapps フォルダにコピーするという手もありますが， 今回は Manager画面から行います．

TomcatのManager画面は以下に示したものです． パスは http://localhost:8080/manager/html になります． もし Manager 画面が表示されない場合には，Tomcat 側に情報が多数ありますので， そちらを参照してください．

このページ真ん中にある WARファイルの配備 からデプロイを行います．表示の通り [ファイルの選択] ボタンをクリックで上がってくるダイアログからファイルを選択し， その後， [配備] ボタンによりデプロイが行われます．

実は本画面はデプロイ後の画面でして， 上のアプリケーションのパスの所に /BaseX922 と表示されているのが見て取れると思います．

サーブレット動作としての BaseX

上記によりデプロイした BaseX サーブレットはWebサーバ機能が動作しているため http://localhost:8080/BaseX922/ からwebページを表示することが可能です．

以下のようなページが表示されれば無事にサーブレットして BaseX が動作しています．

このページに記載されている通り，restやwebdavでアクセスすることが可能です． その際，認証が必要となりますがデフォルトで設定されているユーザ名とパスワードは共に admin となっています．

Ubuntu 18.04 Bionic Beaver Linux 上への gitbucket のインストール

前回の記事（Ubuntu 18.04 Bionic Beaver Linux 上への Tomcat8 サーバのインストール）に書きました通り，ソフトウェアリポジトリとして gitbucket を使ってまして，その準備として Tomcat を前回はインストールしました．

そして本丸である gitbucket のインストールです．

Tomcat 上に gitbucket をインストールする際には，以下の Wiki 記事が参考になります:

Deployment to JEE and Servlet containers

そこには Tomcat 8 向けのインストール方法が箇条書きされてまして，まさにその通りに設定をしていく形になります：

Tomcat 8

1. install java8
2. install tomcat8
3. mkdir /var/gitbucket
4. chown tomcat8:tomcat8 /var/gitbucket
5. echo "GITBUCKET_HOME=/var/gitbucket" >> /etc/default/tomcat8
6. deploy gitbucket.war into /var/lib/tomcat8/webapps
7. service tomcat8 restart

自分が実施した時は手順5のリダイレクトがエラーとなったのですが，内容が明確なため特にエラー内容は確認せずに直接ファイルを修正しました :-)

これによりすぐに gitbucket にアクセス可能となります．なお Tomcat8 のURLが

http://<tomcat8のURL．例えば 192.168.10.1:8080等>

の場合，gitbucket は

http://<tomcat8のURL．例えば 192.168.10.1:8080等>/gitbucket

からアクセス可能です ：

アクセス後，画面右上に表示されている [Sign In] からログイン可能です．
なお初期アカウントは root (パスワードもroot）となります．

root でログイン後，ユーザアカウント設定等を進めていくことになりますが，まずはリポジトリ上のデータ格納場所をどうするかを考える方が良いと思います．それらの設定は右上の System Administration メニューから実施することになります:

この先はデータベースの設定等，gitbucket の各種設定に関する話になりますので，別の記事にしようと思います．

こんな便利なソフトウェアを公開していただいている作者の方には感謝です．

Ubuntu 18.04 Bionic Beaver Linux 上への Tomcat8 サーバのインストール

うちのサーバでは各種ソフトウェアのリポジトリ管理に gitbucket を使用しています．Scala で実装されたオープンソースの Git サーバです．

なお作者の方は日本人でして，僕個人は面識はありませんが，最近トレジャーデータ社に転職されたみたいですね（作者の方のブログはこちら）．

gitbucket自体は単独でもサーバ動作可能なのですが，Java Servlet として実装されており，前のサーバ運用時から Tomcat 上で動作させています．

今回も Tomcat 上でのサーバ動作としたく，まずは Tomcat からのインストールです．

サービス系のソフトウェアをインストールする手順として，これまでは関連する対象ソフトウェア群を個別に apt を使って install した後，設定ファイル等を細かに修正・調整し，サービス起動を自身で行った後，サービスに対してクライアントからの接続操作を行い，その挙動を諸々と確認するということを行っていたため，なかなか手間のかかる作業でした．

最近の Ubuntu では Tasksel というインストールと設定をまとめて実施してくれるツールが使用可能であるため，サービスのインストールも大変楽になりました．

Tasksel の詳細についてはここから確認できます．

また Tasksel を用いた ubuntu18.04 上での各種サービスのインストール詳細についても

LINUXCONFIG.org / YOUR SYSADMIN GUIDE TO GNU/LINUX 

というサイトから確認できます．

今回の tomcat8 のインストールも同サイトの

Install Tomcat 8 server on Ubuntu 18.04 Bionic Beaver Linux

という記事を参考にしました．

便利になりました :-)

具体的な手順は書いてある通りなので省略させて頂く形でお願いします．