11.4. IM-Notice¶

11.4.3.1.1. IM-Notice MQ設定ファイルの編集¶

1. <address>

   • デスクトップ通知で使用するポート番号を設定してください。

     デフォルトでは40608ポートを使用する設定です。

     クライアントからサーバまでのネットワーク機器などに対して、ここで指定したポートを開放してください。

     <address bind="true">tcp://*:40608</address>
     

2. <ping>

   • ping機能の設定をします。

     有効にするには、enable属性に「true」を設定してください。
   • interval-seconds属性で、クライアントにpingを流す間隔を設定します。単位は秒です。
   • time-to-live-seconds属性で、クライアントがサーバに再接続を行うまでの時間を設定します。単位は秒です。

     設定した秒数だけサーバから応答がなければ、クライアントはサーバに再接続を行います。

     <ping enable="true" interval-seconds="270" time-to-live-seconds="300" />
     

   コラム

   環境により、一定時間データが流れないソケットは切断されてしまう場合があります。

   そのような環境では、数分間隔でpingを流し続けることで自動切断を避けることが出来ます。

   （Microsoft AzureやAmazon Elastic Compute Cloudなど）

3. <endpoint>

   • クライアントの接続先を設定します。

     <address>で設定したポート番号を指定してください。

     <endpoints>
         <endpoint>tcp://example.org:40608</endpoint>
     </endpoints>
     

11.4.3.2.1. IM-Notice MQ設定ファイルの編集¶

IM-Juggling で出力されたim-notice-mq-config.xmlを編集してください。

1. <address>

   bind属性にfalseを指定してください。

   <address bind="false">tcp://{ブローカーを実行しているサーバのホストまたはIPアドレス}:{ブローカーのバックエンドポート番号}</address>
   <ping enable="true" interval-seconds="270" time-to-live-seconds="300" />
   <endpoints>
     <endpoint>tcp://{ブローカーを実行しているサーバのホストまたはIPアドレス}:{ブローカーのフロントエンドポート番号}</endpoint>
   </endpoints>
   

コラム

IM-Notice MQ設定ファイルのその他の項目については IM-Notice MQ設定ファイルの編集 を参照してください。

11.4.3.2.2. ブローカーサービス実行ファイルの取得¶

11.4.3.2.3. IM-Notice MQブローカー設定ファイルの編集¶

1. <frontend>

   • デスクトップ通知アプリケーションとの通信を行うポート番号を設定してください。

     デフォルトでは40608ポートを使用する設定です。

     クライアントからブローカーまでのネットワーク機器などに対して、ここで指定したポートを開放してください。

     <frontend bind="true">tcp://*:40608</frontend>
     

2. <backend>

   • Web Application Server との通信を行うポート番号を設定してください。

     デフォルトでは40609ポートを使用する設定です。

     ブローカーからサーバまでのネットワーク機器などに対して、ここで指定したポートを開放してください。

     <backend bind="true">tcp://*:40609</backend>
     

コラム

IM-Notice MQブローカー設定ファイルのその他の項目は IM-Notice ブローカー設定ファイルと同様です。

IM-Notice ブローカー設定ファイルについては IM-Notice MQ設定ファイルの編集 を参照してください。

11.4.3.2.4. ブローカーサービスの実行¶

フォアグラウンドで動作させる場合（例）

java -jar im_notice_mq_broker-8.0.0.jar

nohup java -jar im_notice_mq_broker-8.0.0.jar > stdout.log 2>stderr.log &

コラム

実行したブローカーサービスを停止する場合は、実行方法に応じた停止を行ってください。

上記実行例に対する停止方法は以下です。

• フォアグラウンドでjavaコマンドを実行した場合、Ctrl-C で終了。
• バックグラウンドでjavaコマンドを実行した場合、プロセスIDを調べてkillコマンドで終了。

11.4.5.1.1. GCMAの設定¶

GCMAの設定を行います。

1. Google Play Developer Console にログインしてください。
2. プロジェクトを作成します。

   

3. フォームに以下の内容を入力し、「作成」をクリックしてください。

   
   

   項目	説明
   プロジェクト名	任意の名前を入力してください。
   プロジェクトID	任意のIDを入力してください。

   

4. プロジェクトの概要から「プロジェクト番号」を確認することができます。

   設定ファイルを編集する際に必要な文字列ですので、控えておいてください。

   

5. 「Google Cloud Messaging for Android」を有効にします。

   

6. サーバーアプリケーションのキーを作成します。

   「新しいキーを作成」をクリックします。

   

   「サーバーキー」を選択し、キーを作成してください。

   

7. 「APIキー」を確認することができます。

   設定ファイルを編集する際に必要な文字列ですので、控えておいてください。

   

11.4.5.1.2. IM-Notice Mobile設定ファイルの編集¶

• <proxy>

  1. Google Cloud Messaging for Androidへ接続するためにプロキシを使用する場合、設定を行ってください。

     <proxy enable="true">
         <host></host>
         <port xsi:nil="true"></port> <!-- ポート番号を指定する場合は xsi:nil="true" を削除してください。 -->
         <username></username>
         <password></password>
         <workstation></workstation>
         <domain></domain>
     </proxy>
     

• <gcma>

  1. <gcma>のname属性に任意の名前を設定してください。

     <gcma name="gcma">
     

  2. <api-key>

     • APIキーを設定してください。

  3. <project-number>

     • プロジェクト番号を設定してください。

     コラム

     APIキーおよびプロジェクト番号の確認方法は、 GCMAの設定 を参照してください。

• <push type=”android” />

  1. engine属性に、<gcma>のname属性に設定した名前を指定してください。

  <push type="android" engine="gcma" />
  

• <max-push-subject-length>

  1. Push通知受信時に表示するタイトルの最大文字数を設定してください。

  <max-push-subject-length>30</max-push-subject-length>
  

• <max-push-body-length>

  1. Push通知受信時に表示する本文の最長文字数を設定してください。

  <max-push-body-length>70</max-push-body-length>
  

11.4.5.2.1. GCMA の設定¶

GCMAの設定を行います。

コラム

GCMAの設定方法は、 GCMAの設定 を参照してください。

11.4.5.2.2. Amazon SNS の設定¶

Amazon SNSの設定を行います。

1. Amazon SNS にサインインしてください。

   

2. リージョンを選択してください。

   

3. 「Create and Add」から「Add a New App」を選択してください。

   

4. フォームに以下の内容を入力し、「Add New App」をクリックしてください。

   
   

   項目	説明
   Application Name	任意の名前を入力します。
   Push Platform	「Google Cloud Messaging(GCM)」を選択します。
   API Key	GCMA の設定 で作成したAPIキーを入力します。

   

   
   
5. 「Apps」にアプリケーションが追加されました。

   

6. 「Application ARN」を確認することができます。

   設定ファイルを編集する際に必要な文字列ですので、控えておいてください。

   

11.4.5.2.3. IM-Notice Mobile設定ファイルの編集¶

• <proxy>

  1. Google Cloud Messaging for AndroidやAmazon SNSへ接続するためにプロキシを使用する場合、設定を行ってください。

     <proxy enable="true">
         <host></host>
         <port xsi:nil="true"></port> <!-- ポート番号を指定する場合は xsi:nil="true" を削除してください。 -->
         <username></username>
         <password></password>
         <workstation></workstation>
         <domain></domain>
     </proxy>
     

• <asns>

  1. <asns>のname属性に任意の名前を設定してください。

     <asns name="asns-gcm">
     

  2. <endpoint>

     • Amazon SNSのリージョンに対応するEndpointを設定してください。

       <endpoint>sns.ap-northeast-1.amazonaws.com</endpoint>
       

       コラム

       Endpointは AWS documentation - Regions and Endpoints で確認できます。

       リージョンが「Asia Pacific (Tokyo)」の場合、Endpointは「sns.ap-northeast-1.amazonaws.com」です。

  3. <platform-application-arn>

     • Application ARNを設定してください。

       コラム

       Application ARNの確認方法は、 Amazon SNS の設定 を参照してください。

  4. <access-key>

     • アクセスキーを設定してください。

  5. <secret-key>

     • シークレットキーを設定してください。

     コラム

     アクセスキーおよびシークレットキーは AWS Identity and Access Management（IAM） で作成することができます。

     

  6. <gcma-project-number>

     • プロジェクト番号を設定してください。

     コラム

     プロジェクト番号の確認方法は、 GCMAの設定 を参照してください。

• <push type=”android” />

  1. engine属性に、<asns>のname属性に設定した名前を指定してください。

     <push type="android" engine="asns-gcm" />
     

• <max-push-subject-length>

  1. Push通知受信時に表示するタイトルの最大文字数を設定してください。

  <max-push-subject-length>30</max-push-subject-length>
  

• <max-push-body-length>

  1. Push通知受信時に表示する本文の最長文字数を設定してください。

  <max-push-body-length>70</max-push-body-length>
  

11.4.5.3.1. Baidu の設定¶

Baiduの設定を行います。

11.4.5.3.2. Amazon SNS の設定¶

Amazon SNSの設定を行います。

1. Amazon SNSにサインインしてください。

   

2. リージョンを選択してください。

   

3. 「Applications」から「Create Platform Application」を選択してください。

   

4. フォームに以下の内容を入力し、「Create Platform Application」をクリックしてください。

   
   

   項目	説明
   Application Name	任意の名前を入力します。
   Push Notification Platform	「Baidu Cloud Push for Android in China」を選択します。
   API Key	Baidu の設定で作成したAPI Keyを入力します。
   Client secret	Baidu の設定で作成したSecret Keyを入力します。

   

   
   
5. 「Applications」にアプリケーションが追加されました。

   

6. 「Application ARN」を確認することができます。

   設定ファイルを編集する際に必要な文字列ですので、控えておいてください。

   

11.4.5.3.3. IM-Notice Mobile設定ファイルの編集¶

• <proxy>

  1. Amazon SNSへ接続するためにプロキシを使用する場合、設定を行ってください。

     <proxy enable="true">
         <host></host>
         <port xsi:nil="true"></port> <!-- ポート番号を指定する場合は xsi:nil="true" を削除してください。 -->
         <username></username>
         <password></password>
         <workstation></workstation>
         <domain></domain>
     </proxy>
     

• <asns>

  1. <asns>のname属性に任意の名前を設定してください。

     <asns name="asns-baidu">
     

  2. <endpoint>

     • Amazon SNSのリージョンに対応するEndpointを設定してください。

       <endpoint>sns.ap-northeast-1.amazonaws.com</endpoint>
       

       コラム

       Endpointは AWS documentation - Regions and Endpoints で確認できます。

       リージョンが「Asia Pacific (Tokyo)」の場合、Endpointは「sns.ap-northeast-1.amazonaws.com」です。

  3. <platform-application-arn>

     • Application ARNを設定してください。

       コラム

       Application ARNの確認方法は、Amazon SNS の設定を参照してください。

  4. <access-key>

     • アクセスキーを設定してください。

  5. <secret-key>

     • シークレットキーを設定してください。

     コラム

     アクセスキーおよびシークレットキーは AWS Identity and Access Management（IAM） で作成することができます。

     

  6. <baidu-api-key>

     • Baidu API Keyを設定してください。

     コラム

     Baidu API Keyの確認方法は、Baidu の設定を参照してください。

• <push type=”android” />

  1. engine属性に、<asns>のname属性に設定した名前を指定してください。

     <push type="android" engine="asns-baidu" />
     

• <max-push-subject-length>

  1. Push通知受信時に表示するタイトルの最大文字数を設定してください。

  <max-push-subject-length>30</max-push-subject-length>
  

• <max-push-body-length>

  1. Push通知受信時に表示する本文の最長文字数を設定してください。

  <max-push-body-length>70</max-push-body-length>