Topology に関係する障害とその対処法

この節では、Workstation に生じうるさまざまな問題と、その対処法を説明します。

デバッグログを有効化するには

デバッグログは、エラーや、問題の発生理由に関するその他の有用な情報を記録します。デバッグログを有効にする手順については、 KB483668: トポロジのデバッグログを有効にする方法。

ネットワーク接続されていないときに Services Registration が動作しない

インストール後にネットワーク接続されていない状態でも、すべてのローカルサービスに対して Services Registration は動作します。登録機能が動作しない場合は、コンピューターにログインしているユーザーがローカル管理者であるか確認してください。ネットワークに接続されている状態で Services Registration の十分な権限を有するユーザーであっても、ネットワークに接続されていないときはローカル的に完全な管理者権限を持っていない可能性があります。

サービス登録エージェントは起動できず、プライベート IPV4 アドレスが見つかりませんログファイルで見つかりました

マシンに複数のIPアドレスがある場合は、複数の IP アドレスを用いる環境の設定

マシンにIPアドレスが1つしかない場合は、次のコマンドを使用してネットワーク設定を確認し、IPv4がない以下の表に示す許容されるプライベート (RFC1918) アドレスのリスト。

Windows の場合:
コピー
```
ipconfig/all
```
Linux の場合:
コピー
```
ifconfig -a
```

RFC1918 の名前	IP アドレスの範囲	アドレス数	最大の CIDR ブロック (サブネットマスク)	ホストの ID サイズ	マスクのビット数	クラスフルの説明
24 ビットブロック	10.0.0.0 ～ 10.255.255.255	16,777,216	10.0.0.0/8 (255.0.0.0)	24 ビット	8ビット	単一のクラス A ネットワーク
20ビットブロック	172.16.0.0 ～ 172.31.255.255	1,048,576	172.16.0.0/12 (255.240.0.0)	20ビット	12ビット	16 個の連続したクラス B ネットワーク
16ビットブロック	192.168.0.0 - 192.168.255.255	65,536	192.168.0.0/16 (255.255.0.0)	16ビット	16ビット	256 個の連続したクラス C ネットワーク

ネットワークが想定どおり構成されているか確認してください。想定どおりであり、かつサービス登録機能を使用したい場合は、使用できない IPv4 アドレスにサービス登録エージェントが対応付けられるのを回避するためステップ 4 および 5 を実行します。
に移動Services Registration\yamlフォルダ。

編集するinstallation_list.yamlファイルを追加してバインドアドレス: xxxx領事部へ。コロンと IP アドレスの間には必ずスペースを入れてください。

コピー

consul:
  install_path: "C:\\Program Files (x86)\\MicroStrategy\\Services Registration"
  java_install_path: "C:\\Program Files (x86)\\Common Files\\MicroStrategy\\JRE\\180_192\\Win64\\bin"
  server: false
  retry_join:
   - sap-win2016.labs.microstrategy.com
   - pcheng-W10-PRO.labs.microstrategy.com
   - pcheng-RHEL-6-8.labs.microstrategy.com
  bind_addr: 10.21.20.222

サービス登録エージェントを停止し、Services Registration\dataフォルダ、およびサービス登録エージェントを再起動する。

「MicroStrategy Services Registration is NOT available, please check the service status.」というメッセージが現れる

Workstation Topology を使用してサービスを監視しているときは、空白ページが開き、「MicroStrategy Services Registration is NOT available, please check the service status.」というメッセージが表示されます｡この問題を解決するには、以下の手順に従ってください。

Workstation の接続先の Library コンピューターでサービス登録エージェントが稼働しているか?

Library をインストールしたコンピューターにログインし、MicroStrategy Services Registration が稼働しているか確認します。Windows の場合は Windows Service Manager で確認してください。Linuxでは、 ps -ef | grep 領事。

エージェントが稼働している場合は、クラスターエージェントが正常に形成されているか確認します。見るServices Registration または Topology Monitor のサービスポートの更新詳細についてはこちらをご覧ください。

Library がインストールされているコンピューターにファイアウォールがある場合は、8300 番ポート (TCP) および 8301 番ポート (TCP/UDP) が開いているか確認します。
以下にリストされているマシンにpingを実行してみてください。Services Registration/config/consul.jsonのために " retry_join「マシンにアクセスできるようにします。」
リーダー選出が完了しているか確認します。チェックしてくださいServicesRegistration最新のタイムスタンプを持つログファイルServices Registration/logフォルダ。「リモート状態の同期に失敗しました: クラスターリーダーがありません」というメッセージが表示された場合は、手順 4 と 5 に従ってください。そうでない場合は、ステップ 6 へ進みます。
サービス登録エージェントが稼働している各マシンのクラスター構成が適切か、確認する必要があります。クラスターの構成を確認します。クラスターには、「retry_join「リスト」installation_list.yamlファイル。リストは、すべてのノードで同じでなければなりません。
ダーティデータがないことを確認してくださいServices Registration/dataフォルダ。クラスターの形成やクラスターメンバーの変更が正しく行われなかった場合、データファイル内に無効なデータが残る可能性があります。すべてのエージェントを停止し、Services Registration/data各クラスタノード上のフォルダとすべてのエージェントを再起動するクラスターを形成します。
MicroStrategy Services がインストールされていないコンピューターに MicroStrategy Library が配置されている場合は、consul を管理している Application Server に切り替え、MicroStrategy Library の配置を始めからやり直します。エージェントが動作していない場合は、ServicesRegistration最新のタイムスタンプを持つログファイルServices Registration/logエージェントが起動しない理由を確認するには、フォルダーを参照してください。「プライベートIPv4アドレスが見つかりません」というメッセージが表示される場合は、サービス登録エージェントを起動できません。

エージェントが動作していない場合は、ServicesRegistrationログファイルで最新のタイムスタンプを確認してください。Services Registration\logエージェントを起動できない理由を確認するには、フォルダーを参照してください。

コンピューターに複数の IP アドレスがあるか?製品をインストールしたときにすべての IP が使用可能な状態だったか?

コンピューターに、使用できない IP アドレスがあるか?エージェントが「プライベートIPv4アドレスが見つかりません」と表示した場合は、サービス登録エージェントを起動できません。

MicroStrategy Library WAR ファイルがサーバー上でどのように設置されたか?

Linux サーバーが正常にアップグレードされない場合は、さまざまな問題が考えられます。たとえば Linux サーバーで 10.10 から 11.0 にアップグレードする際に、MicroStrategy インストーラーを実行せずに、WAR ファイルをダウンロードしてコピーした場合などです。このような状況では、 MicroStrategyをインストールするのLinux デプロイメントでのインプレースアップグレードのセクションUpgrade Helpそして展開シナリオのLinux への MicroStrategy Library のインストールのセクションUpgrade Help。

ネットワークアドレス変換 (NAT) を使用してノードが相互に通信しているか?

現在、サービス登録機能は NAT をサポートしていません。

サービスに赤のアイコンが表示される

ワークステーションで停止アイコンにマウスを移動しますツールチップに追加情報を表示します。
考えられる原因が表示されているので、確認してください。
サービスが稼働しているか確認します。サービスをインストールしたコンピューターにログインします。サービスが稼働しているか、Windows Service Manager で確認してください。
必要なポートが使用可能な状態になっているか確認します。サービスが起動に失敗している場合、必要なポートが開いているか確認します。見るサポート対象の MicroStrategy Platform サービスデフォルトのポートを表示します。
構成ファイルに正しいポートが設定されているか確認します。サービスが実行中であるにもかかわらず、Workstationにサービスが停止していると表示される場合は、構成ファイル（MicroStrategy Mobile Server JSP.json）をご利用ください。設定ファイルはインストールディレクトリにあります。MicroStrategy/Services Registration/config。ここに記述されている http/https のポート番号が、実際にサービスが使うポート番号と一致しているか確認してください。
ポートが正しく定義されている場合サービス.jsonファイルが見つかりませんが、Workstationでサービスが停止していると表示される場合は、service.jsonファイル。この URL をブラウザーに貼り付け、有効なリンクであるか確認します。リンクが機能しない場合は、「localhost「」を、URL にアクセスしているマシンの IP アドレスに置き換えて、もう一度お試しください。
ログファイルを確認してください/MicroStrategy/Services Registration/logインストールディレクトリにあります。

インストール後、デフォルト以外のポート番号を使うよう設定した場合、JSON 設定ファイルの方には、この新しいポート番号が反映されていません。JSON 設定ファイルの記述を手動で修正し、MicroStrategy Service Registry を再起動してください。見るServices Registration または Topology Monitor のサービスポートの更新詳細についてはこちらをご覧ください。

サービスを起動/停止できない

対応するユーザーログインに十分な権限が与えられていることを確認し、環境に接続します。Workstation で、管理者権限を有する MicroStrategy ユーザー、または Library の Web コンテナーの管理者ユーザーとして、環境にログインします。メンテナンスモードで [Topology] ビューに移動し、サービスを右クリックして起動/停止機能がサポートされているか確認します。もし、始めるそして停止ポップアップメニューのオプションがグレー表示されている場合、そのサービスでは開始/停止機能はサポートされていません。
当該サービスを実行するコンピューターで、SSH が稼働しているか確認します。そうでない場合は、SSH の設定 (Windows)またはSSH の設定 (Linux)。
ファイアウォールが有効で、22 番ポートが開いているか確認します。
更新されたビューで、サービスの状態を確認します。Workstation から起動/停止要求を送信したのが、他の要求が送信される前であった場合は、[Topology] ビューを更新し、サービスの最新の状態を読み込んでください。

サービスに到達できない

サービスを運用しているコンピューターに、MicroStrategy Library コンピューターから到達できるか確認します。
ファイアウォールがある環境では、サービスを運用しているコンピューターどうしで、8300 番、8301 番ポートを介して TCP/UDP 要求を送受信できるか確認します。
エージェントが稼働しているか確認してください。Windows の場合、Windows Service Manager で MicroStrategy Services Registration の稼働状態を調べます。Linuxでは、ps -ef | grep -i consul。

Linux コンピューターに MicroStrategy 2019 Update 2 Hotfix をインストールした後は、consul が起動しません。

[minimal] オプションを使用して Redhat Enterprise Linux 7 をインストールした場合は、nslookup ツールがありません。consul は、完全修飾ドメイン名 (FQDN) からコンピューターの IP アドレスを解決する際に nslookup コマンドを使用します。consul が正しく起動できるよう、ターミナルで次のコマンドを実行し、足りないツールをインストールしてください。

コピー

# yum install bind-utils

カスタマイズされた配置

ケース1 : 2 台のマシンの環境にトポロジをインストールする場合、MicroStrategy サービスは複数のマシンオプションなしでインストールされます。このため、インストール後にユーザーが手動で consul のクラスターを構成する必要があります。この場合、Library はインストーラーにより配置され、Library Server と Web Server の両方が同じコンピューター上に配置されます。Intelligence Server は別のコンピューターにインストールされます。まず、必要なポートが開いている。

すべてのコンピューターで以下のように操作します。

すべてのコンピューターで Services Registration を停止します。この例の場合、コンピューターの数は 2 台です。
- Windowsでは、サービスマネージャー（走る > サービス.msc ) をクリックして、MicroStrategy サービスの登録を停止します。
- Linuxの場合は、Services Registration の再起動詳細な手順については、こちらをご覧ください。
インストールディレクトリに移動して削除しますMicroStrategy/Services Registration/data。
同じ consul クラスターに属する全コンピューターの Services Registration を再起動します。

Library Server のコンピューターで以下のように操作します。

に移動MicroStrategy/Services Registration/yamlディレクトリ。
開けるinstallation_list.yaml領事部を探します。
追加するretry_joinライブラリサーバーがポイントできるように、パラメータに Intelligence サーバーの FQDN を追加します。
確認するserverパラメータは次のように設定されているfalse。
削除するbootstrap_expect: <number>ライン。

Intelligence Server のコンピューターで以下のように操作します。

に移動MicroStrategy/Services Registration/yamlディレクトリ。
開けるinstallation_list.yaml領事部を探します。
アップデートretry_joinすべての通信エージェントの FQDN を一覧表示します。見るTopology 通信エージェントの指定詳細についてはこちらをご覧ください。
すべての監視エージェントのFQDNを削除するretry_join。
フォーマットを確認してくださいretry_joinに示す形式と一致します監視エージェントを通信エージェントに変更。
追加bootstrap_expect: <number>。見るTopology 通信エージェントの指定詳細についてはこちらをご覧ください。
変化server: trueにserver: false。
ファイルを保存します。

ケース2: JBoss は Intelligence サーバーと同じマシン上で実行されています。Web と Library の両方がインストールされていますが、JBoss 内に配置されています。

Webとライブラリは同じマシン上にあるため、MicroStrategy Web Server JSP.jsonそしてMicroStrategy Library REST Server.jsonは、ServicesRegistration/configインストールフォルダ。アップデートinstallation_list.yaml必要に応じて、Web およびライブラリ JBoss デプロイメントに使用されるポート番号を含むファイル。見るServices Registration または Topology Monitor のサービスポートの更新ポートを更新します。
ヘルスチェックを実行するには、http://localhost:8080/MicroStrategyLibrary/healthそしてhttp://10.248.128.29:8080/MicroStrategy/health。交換する8080 Web とライブラリを実行するポート番号。これで正常に動作しない場合は、「localhost」をコンピューターの IP アドレスに置き換えます。
領事を停止し、ServicesRegistration/dataフォルダ。
Services Registration を再起動します。

Workstation から MicroStrategy Services を監視または制御できない

Intelligence Server、Platform Web、Library, Collaboration Server など、場合によっては、インストーラーが MicroStrategy Services 用の JSON ファイルを正常に生成できないことがあります。このため、Services Registration のインストール先ディレクトリに config サブフォルダーが生成されなかったり、config フォルダーに含まれる JSON ファイルが 1 つだけになったりする可能性があります。これらの現象のいずれかでも発生すると、Workstation から一部またはすべてのサービスを監視したり制御できません。

この問題を解決するには、問題のあるノードに移動して以下の手順を実行してください。

Services Registration のインストール先ディレクトリの jar フォルダーに移動します。
- Windows:
  
  C:\Program Files (x86)\MicroStrategy\Services Registration\jar
- Linux:
  
  /opt/MicroStrategy/ServicesRegistration/jar
次のコマンドを実行します。
コピー
```
# java -jar svcsreg-admin.jar parse
```
config フォルダーに JSON ファイルが生成されていることを確認します。
MicroStrategy Services Registration を再起動します。
- Windows の場合は Windows Service Manager を使用して再起動してください。
- Linux の場合は、次のコマンドを実行します。
  コピー
```
# java -jar svcsreg-admin.jar control consul restart
```
Workstation で [Topology] タブを開きます。今度は、サービスの状態を監視したり、MicroStrategy Services に対し起動/停止コマンドを発行したりできるようになっているはずです。