作業ディレクトリ構造
このページでは、「従来の」作業ディレクトリ構造 (WDS) と「バージョン管理された」作業ディレクトリ構造について説明します。また、バージョン管理された構造を使用する場合についても説明します。さらに、Altair AI Studioのインストール初回起動時に発生する可能性のある移行プロセスについても説明します。
簡単に説明すると
- 従来のWDSは、.RapidMiner作業ディレクトリ(RapidMiner ユーザー ホームとも呼ばれる)であり、2024.0以前のすべてのバージョンのAI Studioおよび他のすべてのAltair RapidMinerアプリケーション(AI Hub など)で使用されます。
- バージョン管理されたWDSは、.AltairRapidMiner/AI Studioフォルダであり、2024.0以降にインストールされたAI Studioの各バージョンのバージョン管理された作業ディレクトリと共有作業ディレクトリを含みます。これはAI Studioでのみ使用されます。他のアプリケーションは影響を受けません。
- AI Studio 2024.0+の特定のインストールを初めて起動すると、以前に古いバージョンを使用していた場合、ディレクトリの移行プロセスが開始されます。
- AI Studio 2024.0+の特定のバージョンをアンインストールしても、後でこれらのファイルが必要になった場合に備えて、バージョン固有の作業ディレクトリは削除されません。古いバージョンをアンインストールし、新しいバージョンを少なくとも一度は起動した後であれば、バージョン管理されたディレクトリを安全に削除することができますが、別のバージョンのAI Studioを使用する予定がある場合は、sharedディレクトリまたは.AltairRapidMiner/AI Studioディレクトリは削除することができません。
従来のWDSとバージョン管理されたWDS
バージョン管理されたWDSを使用する場合
バージョン管理されたWDSは、バージョン2024.0以降にのみ適用されるAI Studioの機能です。旧バージョンのAI StudioおよびJob AgentやAI Hubなどの他のAltair RapidMinerアプリケーションは、引き続き従来のWDSを使用します。
従来のWDS
従来の作業ディレクトリ構造は、AI Studio 2024.0でバージョン管理された作業ディレクトリ構造が導入される前に存在した唯一の構造です。次のように動作します(動作は変わりません)。
- 開始パラメータrapidminer.user-homeでカスタムパスが設定されている場合、このパスが作業ディレクトリとして使用されます。
- カスタムパスが設定されていない場合、rapidminer.execution.working_directoryが設定されていれば、それが読み込まれ、作業ディレクトリとして使用されます。
- 上記の設定がまだ設定されていない場合、~/.RapidMinerパスが設定され、このパスが作業ディレクトリとして使用されます。ほとんどの場合、これがデフォルトです。
すべての作業ディレクトリの内容(キャッシュ、拡張機能、設定、ログなど) は選択した作業ディレクトリに保存されます。作業ディレクトリは「RapidMinerユーザーホーム」と呼ばれることがよくあります。
バージョン管理されたWDS
バージョン管理された作業ディレクトリ構造は、新しいインストールプロセスが考慮されており、異なるバージョンのAI Studioを複数インストールすることができます。同じマシン上で2つの異なるバージョンのAI Studioを実行する際の互換性を保証するために、いくつかのファイルはバージョン固有のコピーとして保持する必要があります。これは、ベース作業ディレクトリ内の新規サブフォルダ構造によって実現されています。ベース作業ディレクトリは従来の作業ディレクトリと同じですが、デフォルトのディレクトリは.RapidMinerではなく.AltairRapidMiner/AI Studioです。このベース作業ディレクトリには、共有作業ディレクトリとバージョン管理された作業ディレクトリ(例：2024.2.1)が含まれます。.RapidMinerのすべてのコンテンツは、必要に応じて.AltairRapidMiner/AI Studio/sharedまたは.AltairRapidMiner/AI Studio/2024.2.1のいずれかに配置されます。
移行プロセス
バージョン管理されたWDS(バージョン2024.0以上)を使用するAI Studioを初めて起動すると、移行プロセスが開始されます。正確なプロセスは、AI Studioの以前の使用状況や起動するバージョンによって異なります。
| AI Studioの新規バージョン X | AI Studioの以前使用していたバージョン Y と Z | アクション / 結果 | コメント |
|---|---|---|---|
| < 2024.0 | 問題なし | ~/.RapidMinerが作成され(まだ存在しない場合)、作業ディレクトリとして使用されます(~はカスタムディレクトリに置き換えることができます)。 | これは従来の作業ディレクトリ構造と呼ばれます。 |
| >= 2024.0 (e.g. X = 2024.2.0) | なし | ~/.AltairRapidMiner/AI Studio/sharedおよび~/.AltairRapidMiner/AI Studio/2024.2.0/が作成され、作業ディレクトリとして使用されます(~はカスタムディレクトリに置き換えることができます)。 | これはバージョン管理された作業ディレクトリ構造と呼ばれます。 |
| >= 2024.0 (e.g. X = 2024.2.0) | Y < 2024.0 | ~/.RapidMinerからバージョン管理された構造へのベース移行が実行されます(詳細は以下を参照)。 | |
| >= 2024.0 (e.g. X = 2024.2.0) | 2024.0 <= Y < X (e.g. Y = 2024.1.0) | ~/.AltairRapidMiner/AI Studio/2024.1.0/から~/.AltairRapidMiner/AI Studio/2024.2.0/へのバージョン移行が実行されます(詳細は以下を参照)。 | |
| >= 2024.0 (e.g. X = 2024.2.0) | X < Y (e.g. Y = 2024.3.0) | バージョン管理された作業ディレクトリ~/.AltairRapidMiner/AI Studio/2024.2.0/が作成され、ファイルが生成されます。 | 互換性を確保するため、移行は一切行いません。 |
| >= 2024.0 (e.g. X = 2024.2.0) | Z < 2024.0 <= X < Y (e.g. Z = 10.2.0, Y = 2024.3.0) | バージョン管理された作業ディレクトリ~/.AltairRapidMiner/AI Studio/2024.2.0/は、従来の~/.RapidMinerから移行されます。 | これはバージョン管理されたコンテンツのみの基本移行です。 |
基本移行
利用可能な従来の作業ディレクトリがあるが、バージョン管理された作業ディレクトリが必要な場合、基本移行がトリガーされます。これは基本的に、利用可能な作業ディレクトリのすべてのファイルを、新しく作成されたバージョン管理の作業ディレクトリ構造にコピーします。すべての共有コンテンツは共有フォルダにコピーされ、それ以外のものはすべて現在のバージョンフォルダにコピーされます。その他の移行手順は以下の通りです。
- extensions.xml(以前は.RapidMiner/managedにありました)はバージョン固有のフォルダに移動されます。
- 作業ディレクトリにつながる設定ファイルのパスはそれに応じて調整されます。
バージョン移行
バージョン管理された作業ディレクトリ構造がすでに存在するが、現在のバージョンが初めて起動されるため、そのバージョンのフォルダが存在しない場合、バージョン移行が開始されます。現在の最新バージョンのディレクトリを探し(例えば、2024.1.0と2024.2.0のディレクトリがある場合、2024.2.0のディレクトリが選ばれます)、それを現在のバージョンの新規フォルダにコピーします。
これは、現在起動されているバージョンの下にバージョン管理されたディレクトリがある場合にのみ発生します。バージョン管理された構造があるが、古いバージョン管理されたディレクトリがない場合、現在必要なディレクトリがあれば、従来の構造から移行される可能性があります。そうでない場合は、AI Studioの一般的な初回起動として扱われます(つまり、移行プロセスは行われません)。
