Linux上のホストエージェントのトラブルシューティング

問題点：

Debianの派生製品では、以下のような出力が表示されるかもしれない：

  Setting up Instana APT repository
  Importing Instana GPG key
  Updating apt metadata ...
  E: The method driver /usr/lib/apt/methods/https could not be found.
  APT repository metadata update failed

解決方法この場合、Aptは現在 HTTPS サーバーからフォントを取得しないため、 apt-transport-https 。

問題: SUSE Linux Enterprise Server12の場合、次のような出力が表示されることがあります：

  Setting up Instana agent for GNU/Linux
  Setting up Instana zypper repository
  Updating zypper metadata ...
  Installing Instana agent ...
  Error building the cache:
  [instana-agent|https://_@packages.instana.io/agent/generic/x86_64] Valid metadata not found at specified URL
  Some of the repositories have not been refreshed because of an error.
  No provider of 'instana-agent-static' found.
  Instana agent package install failed

解決方法最新の HTTPS 接続でアーティファクトを適切に受信できるように、 opensslを更新する必要があります。 ホストエージェントのネットワーク要件については、 「 Instana エージェントのネットワーク要件」 を参照してください。

問題： CentOS-6ベースのシステムでは、以下の出力が表示されることがあります：

Setting up Instana agent for GNU/Linux
Setting up Instana YUM repository
Updating YUM metadata ...
YUM repository metadata update failed

解決方法libcurlのバージョンを更新する。

RHEL システムでは、次のような問題が発生する可能性があります：

• 問題：次のような出力が表示されるかもしれない：

  Error unpacking rpm package instana-agent-dynamic-20210630-0948.x86_64
  Error: Transaction failed
  

  解決方法連邦情報処理標準(FIPS)またはSELinuxが有効になっていると、ワンライナーのインストール中に次のようなエラーが発生することがある。 ホストエージェントをインストールするときは、FIPS と SELinux を無効にしてください。

• 問題：以下のセットアップでは、「instana-agentパッケージの手動インストールに失敗する：

  sudo rpm -ivh instana-agent-dynamic-20210713-1352.x86_64.rpm
  ...
  error: unpacking of archive failed on file /etc/init.d/instana-agent;60eda3b3: cpio: Digest mismatch
  error: instana-agent-dynamic-20210713-1352.x86_64: install failed
  

  解決方法手動インストールの回避策として、以下のコマンドで検証をスキップすることができます：

  sudo rpm -ivh --nodigest --nofiledigest instana-agent-dynamic-20210713-1352.x86_64.rpm
  

Debianのデリバティブの場合、以下のような問題が発生する可能性がある：

• 問題：次のような接続エラーメッセージが表示されることがあります：

  GnuTLS recv error (-9): A TLS packet with unexpected length was received
  

  解決方法このバグは、Curl、Git、aptのようなGnuTLS-dependingプログラムで見つかります。

• 問題：インストールを実行すると、次のような出力が表示されることがあります。

  E: The method driver /usr/lib/apt/methods/https could not be found.` `APT repository metadata update failed
  

  解決方法この場合、Aptは現在 HTTPS サーバーからフォントを取得しないため、 apt-transport-https 。

SUSE Linux Enterprise Server12では、次の問題が発生する可能性があります：

• 問題：次のような出力が表示されるかもしれない：

  Error building the cache:
  [instana-agent|https://_@packages.instana.io/agent/generic/x86_64] Valid metadata not found at specified URL
  Some of the repositories have not been refreshed because of an error.
  No provider of 'instana-agent-static' found.
  Instana agent package install failed
  

  解決方法 GnuTLS, OpenSSL,、NSSライブラリとその依存プログラム（Curlなど）を更新する必要があります。 このアップデートは、最新の HTTPS 接続でアーティファクトを適切に受信するために重要である。

• 問題： systemd を使用してサービスを instana-agent 有効にしようとすると、 SUSE Enterprise Linux で次のようなエラーメッセージが表示される場合があります：

  systemctl enable instana-agent
  
  Synchronizing state of instana-agent.service with SysV service script with /usr/lib/systemd/systemd-sysv-install.
  Executing: /usr/lib/systemd/systemd-sysv-install enable instana-agent
  ln -sf ../instana-agent /etc/init.d/rc2.d/S50instana-agent
  ln: failed to create symbolic link '/etc/init.d/rc2.d/S50instana-agent': No such file or directory
  

  解決策：

  1. /etc/init.d/instana-agentファイルを削除する。

  2. 次のコマンドを実行します。

     systemctl enable instana-agent
     

     すると、シンボリックリンクが正しく作成されていることが確認できる：

     systemctl enable instana-agent
     
     Created symlink /etc/systemd/system/multi-user.target.wants/instana-agent.service → /lib/systemd/system/instana-agent.service.`
     

CentOS6ベースのシステムでは、以下の問題が発生する可能性があります：

問題：次のようなログが出力されることがある：

Updating YUM metadata ...
YUM repository metadata update failed

解決方法libcurlのバージョンを更新する。