• サポート
• 導入と環境構築

導入と環境構築

• どのパッケージを使えばいいですか？

  BoltzEngine には、複数のサービスが存在し、用途に応じて使用するパッケージが異なります。

  • 各パッケージの概要主に以下のようなサービスが存在しています。
  • 導入のヒントそれぞれのサービスがどういった用途で使えるかを説明します。
  • API を使いたいけど gRPC や net/rpc は難しいgRPC が対応していない言語から API を実行したい場合など、そういった用途には、REST 形式の HTTP API も用意しています。
  • 導入が必要なパッケージ上記それぞれの場合で、必要なパッケージを説明します。
• Linux 版 BoltzEngine のログを確認する方法は

  -log オプションの値によってログの出力先が変わります。
• Windows 版 BoltzEngine のログを確認する方法は

  Windws 版 BoltzEngine のログは Windows のイベントログに記録されます。
• EL7環境において BoltzMessenger で複数環境に対応するには

  BoltzMessenger が利用するデータベースと各種設定を、環境分だけ作成いただく必要があります。

  • DBにデータベースを追加BoltzMessenger が利用するデータベースを作成するには、boltz-messenger-init コマンドを使います。
  • BoltzMessenger の設定ファイルをコピーBoltzMessenger の設定ファイル /etc/boltz-messenger/config.yml をコピーします。
  • boltz-messenger-gatewayをコピーするboltz-messenger-gateway は管理画面に登録した通知の配信管理サービスです。
  • 管理画面を分離する管理画面も boltz-messenger-gateway と同じ設定ファイルを参照します。
  • Web API / BoltzMessenger Webを分離する2.2 以降をお使いの場合、アプリ用の API やウェブプッシュ受信画面は、BoltzMessenger Web というパッケージに含まれるようになりました。
  • 制限事項BoltzMessenger Web を同一ドメインに複数設置した場合、ウェブプッシュ受信画面に関する設定は最後にアクセスした画面のものが有効となり、チャンネル・セグメントの設定が失われます。
• Linux 版で複数のスレーブノードを使用した構成を設定するには

  一つの BoltzEngine (Master) が複数の BoltzEngine (Slave) を集約するように構成する方法です。

  • boltz-node1boltz-node1 の /etc/sysconfig/boltz/master を以下のように変更します。
  • boltz-node2BoltzEngine (Slave) だけを実行する場合は特に設定変更は必要ありません。
  • 動作確認boltz-node1 と boltz-node2 の起動が完了してしばらくすると、BoltzEngine (Master) のステータスにスレーブが複数あらわれます。
• Linux 版 BoltzEngine をアップデートするには

  こちらのページの手順で操作を行ってください。

  • サービスの停止起動中のサービスを停止します。
  • パッケージの更新BoltzEngine は RPM の形で提供していますので、インストールされているパッケージを更新してください。
  • DBマイグレーション(BoltzMessenger をお使いの場合のみ)この手順は BoltzMessenger をお使いの方のみ必要です。
  • サービス再起動一通り完了したら、サービスの再起動を行ってください。
• Windows 版 BoltzEngine をアップデートするには

  新しいバージョンのインストーラを実行いただき、画面の通りに進めてください。

  • 1.3 までのバージョンを使うの場合1.3 までのバージョンは、インストールの最後に設定ファイルを更新してしまうため、事前に C:\ProgramData\boltz-messenger\config.yml を退避していただいて、インストールを終えてから、退避しておいたファイルを戻してください。
• 体験版から製品版にアップグレードするには

  プロダクトキーファイルを置き換えて再起動することで反映できます。

  • BoltzEngine マスターサービスの再起動ライセンスファイル置き換え後、BoltzEngine マスターサービスを再起動します。
  • その他の関連サービスについて使用したいバージョンと一致している場合、BoltzMessenger や HTTP API Proxy はそのままご利用できます。
• 性能試験を行う方法はありますか

  実際に端末を用意しなくても、同じトークンを使いまわすことで類似の試験を行うことが可能です。

  • 実施方法まずは、トークンの取得を行うアプリを作成し、トークンを集めます。
  • 注意事項何度も同じトークンを使って通知を行うため、同一の端末へ大量の通知が届きます。
• 送信時に too many open files エラーが発生した場合

  BoltzEngine で同時に大量のメッセージを通知してエラーが発生する場合の対応方法です。

  • エラーの原因この too many open files エラーは、1つのプロセスが一定以上(ulimit -n以上)のファイルを同時に開いた場合に発生するエラーです。
  • 対応方法エラーの原因は上記の通りのため、ulimit -n の値を増やせば回避可能です。
  • 注意事項このエラーは、1 つの通知リクエストに含まれるターゲットの一部にだけ発生します。
• Google Cloud Messaging から Firebase Cloud Messagingへの移行

  2019 年 4 月 11 日までに FCM への移行を完了させる必要があります

  • 移行作業の要否の確認BoltzEngine を使用しているプロジェクトで GCM から FCM への移行作業が必要になるかどうかは、以下の点から確認できます。
  • プロジェクトの移行Firebase Console を開き、[プロジェクトを追加]を選択します。
  • アプリの移行ここでは、Android Studioにて、com.google.android.gms:play-services-gcm をお使いの場合の対応をご紹介します。