環境変数の設定

このトピックでは、インテル® Advisor の環境変数の設定に関するガイドを提供します。

次のことを行い場合は環境変数を設定します。

インテル® Advisor コマンドライン・インターフェイスを実行する
コマンドライン (Linux*) からインテル® Advisor グラフィカル・ユーザー・インターフェイスを実行する
追加のインクルード・ディレクトリーを使用して、インテル® Advisor アノテーションを挿入したアプリケーションをコンパイルすると、コンパイラーはアノテーションを定義するインクルードファイルを検出できます。

次のいずれから方法で変数を設定できます。

推奨事項スクリプトで変数を設定する。
手動で変数を設定する。この方法で特定のインテル® Advisor の場所の変数を設定したり、変数を永続的に設定することができます。

デフォルトのインストール・パス

次の手順では、 <version> や <install-dir> などの山カッコ内の値を、利用するシステムの値に置き換えてください。 <version> は、インテル® Advisor がリリース年と更新バージョンなど (例: 2021.1) です。アプリケーションのデフォルトのインストール・パス <install-dir> は、次のいずれかです。

Linux* :
- /opt/intel/oneapi (root ユーザー向け)
- $HOME/intel/oneapi (一般ユーザー向け)
Windows* : C:\Program Files (x86)\Intel\oneAPI

32 ビットシステムでは、 Program Files (x86) フォルダーは Program Files になります。
On macOS*: /opt/intel/oneapi

スクリプトで変数を設定

これは、インテル® Advisor の環境変数を設定するのに推奨される方法です。特に、専用の Python* スクリプトを使用してオフロードのモデル化を実行する際に使用します。スクリプトは、インテル® Advisor のインストール・ディレクトリーを指す必要となるすべての変数を自動的に設定します。

Linux OS and macOS

次シェルスクリプトを実行します。

source <install-dir>/setvars.sh

source <install-dir>/setvars.csh

このスクリプトは、システムにインストールされている最新バージョンのインテル® Advisor をセットアップします。

注

システムのインストールされている下位バージョンのインテル® Advisor 向けに環境をセットアップする場合は、次のインテル® Advisor 固有のスクリプトを使用します。

source <install-dir>/advisor/<version>/env/vars.sh

source <install-dir>/advisor/<version>/env/vars.csh

ここで <version> は、使用するインテル® Advisor のバージョンです。

Windows*

次のバッチファイルを実行します。

<install-dir>\setvars.bat

このスクリプトは、システムにインストールされている最新バージョンのインテル® Advisor をセットアップします。

注

source <install-dir>/advisor/<version>/env/vars.sh

source <install-dir>/advisor/<version>/env/vars.csh

ここで <version> は、使用するインテル® Advisor のバージョンです。

手動で環境変数を設定

Linux* と macOS*

ターミナルを開きます。
現在の環境変数の設定を確認します。例えば、 bash シェルで以下を実行します。
env | grep ADVISOR_<version-year>_DIR

ここで <version-year> は、使用するインテル® Advisor のメジャーバージョンです (例: 2023)。

適切なインテル® Advisor のインストール・ディレクトリーが変数に定義されている場合、次の手順はスキップしてインテル® Advisor の起動に進んでください。
export コマンドを使用して環境変数を設定します。以下を入力します:
export ADVISOR_<version-year>_DIR="<install-dir>"

例えば、デフォルトのインストール・ディレクトリー内のインテル® Advisor 2023 では、次のようになります。
```
export ADVISOR_2023_DIR="/opt/intel/oneapi/advisor/latest"
```
現在のシステムで常にこの変数を設定するには、 .login または同等のシェル初期化ファイルにこの定義を追加します。
環境変数の設定を確認します。
env | grep ADVISOR_<version-year>_DIR

ターミナルに環境変数名とその値が出力されます。

Window*

コマンドプロンプトを開きます。
現在の環境変数の設定を確認します。例えば、次のように入力します。
set ADVISOR_<version-year>_DIR

ここで <version-year> は、使用するインテル® Advisor のメジャーバージョンです (例: 2023)。

適切なインテル® Advisor のインストール・ディレクトリーが変数に定義されている場合、次の手順はスキップしてインテル® Advisor の起動に進んでください。
set コマンドを使用して環境変数を設定します。以下に例を示します。
set ADVISOR_<version-year>_DIR="<install-dir>"

例えば、インテル® Advisor 2023 では、次のようになります。
```
set ADVISOR_2023_DIR="C:\Program Files (x86)\Intel\oneAPI\advisor\latest"
```
システムでこの環境変数を常に設定するには、 [コントロールパネル] > [システム] > [システムの詳細設定] > [環境変数...] を開いて、システムまたはユーザーの環境変数にこの定義を追加します。

追加の変数

以下を考えてみます。次の環境変数を設定します:

評価向けの機能が有効であるかどうか確認するには、 ADVISOR_EXPERIMENTAL 環境変数を設定します。
oneTBB を利用するプログラムを実行する際に、インテル® oneAPI スレッディング・ビルディング・ブロック (oneTBB) のインクルード・ディレクトリーを検出するには、 TBBROOT 環境変数を設定します。 TBBROOT 環境変数を定義を参照してください。
Linux* と macOS* では、インテル® Advisor は、Linux* システムの BROWSER 環境変数を使用して、インストールされている HTML ブラウザーを検索します。これにより、インテル® Advisor GUI [Help (ヘルプ)] メニューから、導入ガイド」や「ヘルプ」を表示できるようになります。
Linux* と macOS* では、 VISUAL または EDITOR 環境変数を使用して、 [Source (ソース)] ウィンドウで行をダブルクリックした時に起動される外部エディターを指定できます。 VISUAL は EDITOR よりも優先されます。

次のステップ

GUI またはコマンドライン・インターフェイスからインテル® Advisor を起動します。