1. Oracle CloudでのOracle Analytics Serverのデプロイ
  2. トラブルシューティング

B トラブルシューティング

このトピックでは、Oracle Cloud上でOracle Analytics Serverのデプロイ時に発生する可能性がある一般的な問題とその解決方法について説明します。

Oracle Analytics Serverのスタックの作成中に問題が発生しました

Oracle Cloud Infrastructureコンソールで、スタック・ジョブの「ログ」ページに移動します。スタック・ジョブの「ログ」ページ

どうすればよいかわからない場合は、Oracle Supportにお問い合せください。

インストールに関するその他の問題は、どのように診断すればよいですか。

Oracle CloudにOracle Analytics Serverをデプロイすると、Oracle Analytics Server用に作成されたコンピュート・インスタンス上の/var/logディレクトリに、次のようないくつかのログが保存されます。

お気に入りのSSHクライアントを使用してOracle Analytics Serverコンピュート・インスタンスにログインすると、これらのログにアクセスできます。opcユーザーとしてログインし、oracleユーザーに切り替えて、/var/log/oas_create_domain.logファイルを開きます。

  • /u01/app/oas-scripts/oas_install.finish - インストールが完了したことを示します。

  • /var/log/oas_cloudinit.log - インストール・プロセス全体で進捗情報を記録します。たとえば、スクリプトの生成、スクリプトの実行、ドメイン作成に使用されるファイルbiconfig、ファイアウォールでポートを開くために使用される構成ファイルDefaultSingleNodeOASFirewallPorts.xmlとスクリプト・ファイルopen_oas_firewall_ports.sh、およびクリーン・アップ・フェーズ中に削除されるファイルの詳細について、メッセージを確認できます。

  • /var/log/oas_create_domain.log - ドメイン作成フェーズの間にステータス情報を記録します。ドメインの作成が成功すると、次のメッセージが表示されます。 

    [CONFIG] SUCCESS:Collect logs Configuration:Oracle_Analytics_Configuration completed successfully 
The configuration of Oracle Distribution completed successfully.

    問題が発生すると、問題の説明を含むエラー・メッセージが表示されます。

データベースへの接続の問題を確認するにはどうすればよいですか。

データベース接続エラーは、誤った接続文字列、不正なユーザー名またはパスワード、製品スキーマに対して無効または重複した接頭辞など、様々な理由で発生する可能性があります。

接続文字列が正しくありません

SSHを使用して、Oracle Analytics Serverのコンピュート・インスタンスにアクセスします。opcユーザーとしてログインし、oracleユーザーに切り替えて、/var/log/oas_create_domain.logファイルを開きます。次の例に示すようなエラー・メッセージは、データベースにアクセスできないか、データベースの接続文字列が正しくないことを示します。 

Validations are enabled for this session.
Verifying data
[VALIDATION] [ERROR]:Error connecting to 'Oracle database at host <IP address> port 1521 service name
        pdb.sub07132220290.sgvcn.oraclevcn.com'.  Error: 'Listener refused the connection with the following error:
ORA-12514, TNS:listener does not currently know of service requested in connect descriptor '
 - Invalid service name.
[VALIDATION] [SUGGESTION]:Make sure the database is up and running and connect string, user name and password are correct.
Configuration Failed. Exiting configuration due to data validation failure.

ユーザー名またはパスワードが正しくありません

SSHを使用して、Oracle Analytics Serverのコンピュート・インスタンスにアクセスします。opcユーザーとしてログインし、oracleユーザーに切り替えて、/var/log/oas_create_domain.logファイルを開きます。次の例に示すようなエラー・メッセージは、データベースに接続するために指定された資格証明が無効であることを示しています。 

Validations are enabled for this session.
Verifying data
[VALIDATION] [ERROR]:Error connecting to 'Oracle database at host <IP address> port 1521 service name <PDB_Name>.<DB domain>' 
- Invalid user name/password
[VALIDATION] [SUGGESTION]:Make sure the database is up and running and connect string, user name and password are correct. Enter a valid user name with DBA privileges
Configuration Failed. Exiting configuration due to data validation failure.
ユーザー名またはパスワードに無効な文字が含まれている場合、次のようなエラー・メッセージが表示されます。
Validations are enabled for this session.
Verifying data 
[VALIDATION] [ERROR]:Password contains invalid characters 
[VALIDATION] [SUGGESTION]:Ensure password contains only alphanumeric, underscore (_), dollar ($) or pound (#) characters configuration Failed. 
Exiting configuration due to data validation failure.
パスワードの長さが正しくない場合、次のようなエラー・メッセージが表示されます。
Validations are enabled for this session.
Verifying data 
[VALIDATION] [ERROR]:Password field 'ADMIN_PASSWORD' must have at least '1' numerals 
[VALIDATION][SUGGESTION]:Enter a more complex password with numerals [VALIDATION] [ERROR]:Password field 'ADMIN_PASSWORD' must be at least '8' characters long 
[VALIDATION][SUGGESTION]:Enter a longer password

製品スキーマの接頭辞が無効または重複しています

SSHを使用して、Oracle Analytics Serverのコンピュート・インスタンスにアクセスします。opcユーザーとしてログインし、oracleユーザーに切り替えて、/var/log/oas_create_domain.logファイルを開きます。次の例に示すようなエラー・メッセージは、Oracle Analytics Server製品スキーマに対して無効な接頭辞または重複する接頭辞が指定されていることを示します。 

Validations are enabled for this session.
ACTION - RCU-6016 Specify another prefix.
ERROR - RCU-6016 Invalid prefix specified.
CAUSE - RCU-6016 The specified prefix already exists.[Create schemas using RCU]:2021-11-03T10:52:07.479+0000 
ERROR - RCU-6091 Component validation failed.
CAUSE - RCU-6091 One or more component specific validation failed.

データベース・ホストまたはポートにアクセスできません

SSHを使用して、Oracle Analytics Serverのコンピュート・インスタンスにアクセスします。opcユーザーとしてログインし、oracleユーザーに切り替えて、/var/log/oas_create_domain.logファイルを開きます。次のようなエラー・メッセージは、データベース・ポートにアクセスできないことを示している場合があります。 

Validations are enabled for this session. 
Verifying data 
[VALIDATION] [ERROR]:Error connecting to 'Oracle database at host <hostname> port 1521 service name <service_name>' - Listener could be down
[VALIDATION] [SUGGESTION]:Make sure the database is up and running and connect string, user name and password are correct. configuration Failed. Exiting configuration due to data validation failure.
  1. netcatユーティリティを使用して、データベース・ポートへの接続を確認します。

    ノート:

    このユーティリティを使用できない場合は、ユーザーまたは管理者がnetcatをインストールする必要がある場合があります。 
    sudo yum install nmap-ncat.x86_64
  2. 次のコマンドを使用してデータベース接続をテストします。
    sudo nc -zv <database host or IP> <database port>
  3. 接続に失敗した場合は、データベースとリスナーが稼働していることを確認し、データベース計算ノードからの接続を受け入れることができます。
  4. そのデータベースを構成する際に指定したVCNのイングレス・ルール(セキュリティ・リストまたはネットワーク・セキュリティ・グループ内)を使用して、そのデータベース・ポートが接続のために開かれるようにします。
    1. データベースおよびOracle Analytics Serverに関連付けられているVCNに移動します。
    2. 「セキュリティ・リスト」をクリックします。
    3. 「デフォルト・セキュリティ・リスト」をクリックしてから、「すべてのルールの編集」ボタンをクリックします。
    4. 次のように設定されたイングレス・ルールを追加します。
      • ソースCIDR: 0.0.0.0/0
      • 宛先ポート: 1521 (または任意のデータベース・ポート)
  5. netcatを使用して接続を再テストし、Oracle Analytics Serverコンピュート・インスタンスからそのポートへのアクセスを確認します。

Oracle Analytics Serverスタックを作成しようとすると、失敗した認可または見つからないリソースに関するエラー・メッセージが表示されるのはなぜですか。

manage orm-familyポリシーがない場合は、Oracle Analytics Serverスタックを作成しようとすると、次のエラー・メッセージが表示されます。
Authorization failed or requested resource not found

管理者に次のポリシーでグループに割り当てるよう依頼してください。

allow group myoasgroup_name to manage orm-family in compartment myoas-compartment_name

Oracle Cloud Infrastructureでのポリシーの設定を参照してください。

Oracle Analytics Serverスタックの作成時にエラー・メッセージ 404-NotAuthorizedOrNotFoundが表示されるのはなぜですか。

manage instance-familyポリシーがない場合は、Oracle Analytics Serverスタックを作成するときに、次のエラー・メッセージが表示されます。
Error: 404-NotAuthorizedOrNotFound...
Service: Core Instance
Error Message: Authorization failed or requested resource not found.

管理者に次のポリシーでグループに割り当てるよう依頼してください。

allow group myoasgroup_name to manage instance-family in compartment myoas-compartment_name

Oracle Cloud Infrastructureでのポリシーの設定を参照してください。

パブリックIPアドレスとサブネットに関するエラー・メッセージが表示されるのはなぜですか。

プライベート・サブネットにデプロイされているOracle Analytics Serverコンピュート・インスタンスにパブリックIPアドレス(エフェメラル・パブリックIP)を割り当てることはできません。プライベート・サブネットを使用する場合は、スタック・オプション「パブリックIPアドレスの割当て」を選択しないでください。そうした場合、次のエラー・メッセージが表示されます。
Public IP addresses are prohibited in this subnet {ocid1.subnet...

最大スタック制限のエラー・メッセージが表示されるのはなぜですか。

Oracle Cloud Infrastructureにサインアップする場合、テナンシにサービス制限のセットが構成されます。テナンシで許可されるスタックの最大数に達した場合、Oracle Analytics Serverスタックを作成しようとすると、次のエラー・メッセージが表示されます。
Tenancy has reached maximum limit for total stacks.

サービス制限の引上げのリクエストを参照してください。

パスワードが正しくないか無効なためにドメインの作成が失敗した場合はどうすればよいですか。

正しいパスワードを使用してドメインを手動で作成します。Oracle Analytics Serverドメインを手動で作成する方法を参照してください

/u01/data/domains/biがすでに存在するためドメインの作成に失敗した場合はどうすればよいですか。

SSHを使用して、Oracle Analytics Serverのコンピュート・インスタンスにアクセスします。opcユーザーとしてログインし、oracleユーザーに切り替えて、/var/log/oas_create_domain.logファイルを開きます。次のようなエラー・メッセージは、前回のドメイン作成試行が正しくクリーン・アップされていない状態でもう一度ドメイン作成を試行したことを示しています。 

[VALIDATION] [ERROR]:Domain '/u01/data/domains/bi' already exists - A file or directory '/u01/data/domains/bi' already exists 
[VALIDATION] [SUGGESTION]:Choose a new unused location configuration Failed. Exiting configuration due to data validation failure.
  1. 次のようにドメインをクリーン・アップします。
    rm -rf /u01/app/Oracle/Middleware/Oracle_Home/user_projects/applications/bi
rm -rf /u01/data/domains/bi
  2. ドメインを手動で作成します。create_oas_domain.shスクリプト・ファイルを実行する前に、次のいずれかを実行する必要があります。
    • 構成ファイルbiconfig.rspを編集し、新しい一意のスキーマ名を構成します。
    • RCUユーティリティを実行し、失敗したドメイン作成の試行中に作成された、使用されていないスキーマを削除します。

    Oracle Analytics Serverドメインを手動で作成する方法を参照してください

インストールは完了しましたが、ブラウザでURLを入力してOracle Analytics Serverにアクセスできません。何を行う必要がありますか。

SSHを使用して、Oracle Analytics Serverのコンピュート・インスタンスにアクセスします。opcユーザーとしてログインし、oracleユーザーに切り替えて、フォルダ/u01/data/domains/bi/bitools/binに移動します。status.shを実行して、必要なすべてのサービスが実行されているかどうかを確認します。

次の情報が表示されます:
Domain status; Using domainHome:/u01/data/domains/bi/bitools/bin… 
Initializing WebLogic Scripting Tool (WLST) ...
Welcome to WebLogic Server Administration Scripting Shell
Type help() for help on available commands

/Servers/AdminServer/ListenPort=9500
Accessing admin server using URL t3:/<compute instance name>:9500

AdminServer already running
Status of Domain: /u01/data/domains/bi
NodeManager (<compute instance name>:9506:SSL): RUNNING

Name         Type    Machine                  Restart Int  Max Restart  Status
----         ----    -------                  -----------  -----------  ------
AdminServer  Server  <compute instance name>  unknown      unknown      RUNNING
bi_server1   Server  <compute instance name>  unknown      unknown      RUNNING
obips1       OBIPS   <compute instance name>  3600         5000         RUNNING
obijh1       BIJH    <compute instance name>  3600         5000         RUNNING
obiccs1      OBICCS  <compute instance name>  3600         5000         RUNNING
obisch1      OBISCH  <compute instance name>  3600         5000         RUNNING 
obis1        BIS     <compute instance name>  3600         5000         RUNNING

いずれかのサービスが停止している場合は、start.shを使用してOracle Analytics Serverを手動で再起動します。Oracle Analytics Serverの起動に関する項を参照してください。

Oracle Analytics Serverで自動機械学習機能を使用できないのはなぜですか。

追加のライブラリをインストールする必要があります。Oracle Analytics Serverでの機械学習のための追加ライブラリのインストールを参照してください。

Marketplaceのヘルプを入手するにはどうすればよいですか。

Oracle Cloud Marketplaceの一般的なヘルプは、Oracle Cloud Marketplaceの使用のサポートを受ける方法を参照してください。

Oracleサポートにいつ連絡すればよいですか。

Oracle CloudにOracle Analytics Serverをデプロイするときに問題が発生する場合は、ユーザー・インタフェースに表示されるエラー・メッセージを記録し、Oracle Supportにお問い合せください。

オンプレミスのBYOLライセンスを使用してOracle CloudにOracle Analytics Server - BYOLをデプロイした場合は、Oracle Fusion Middlewareでサービス・リクエストをログに記録します。Oracle Cloudアカウント(Pay As You Goまたは年次ユニバーサル・クレジット)を使用してOracle Analytics Server - UCMをデプロイした場合は、Oracle Cloudでサービス・リクエストをログに記録します。問合せはOracle Analytics Serverチームに転送されます。