レガシーのRapidMiner ServerへのPython Scriptingエクステンションのインストール

本ページの見方

このページでは、RapidMiner ServerのデプロイメントにPython Scriptingエクステンションをインストールして設定する方法を説明します。

まず、前提条件が満たされていることを確認してから、拡張機能をインストールしてください。

Webサービスのデプロイに使われるプロセスの中でPythonコードを実行したい場合は、以下の手順で行います。

通常のプロセス実行の一部としてPythonコードを実行したい場合は、以下の手順に従ってください

前提条件の確認

まず、前提条件がすべて満たされていることを確認してからお進みください。

1. RapidMiner Server（下記参照）が動作するマシンに、以下のコンポーネントがインストールされていることを確認してください。
   • Pythonインタープリタ（Anaconda ディストリビューションの使用を推奨）
   • Pythonパッケージ  pandas
   • (可能であれば、)RapidMiner Serverのデプロイメント（Serverインスタンスと接続されたすべてのジョブエージェント）において、Pythonの環境は同じであるべきです。
2. RapidMiner ServerでWebサービスとしてプロセスを実行する場合、RapidMiner Serverコンポーネントを実行しているマシン上で上記の要件を満たしているか確認してください。
3. プロセスを定期的に実行する場合、スケーラブルなジョブエージェントアーキテクチャでは、RapidMiner Serverのデプロイメントにおいてジョブエージェントが実行されるすべてのマシン上で上記の要件を満たしているか確認してください

エクステンションのインストール

RapidMiner Server上に、RapidMiner Serverプロセスの作成に使用したすべてのRapidMiner Studioインスタンスと同じバージョンのエクステンションがインストールされているか確認してください。

エクステンションページの指示に従って、マーケットプレイスでPython Scriptingエクステンションを探し、RapidMiner Serverマシンの指定された場所にダウンロードします。

Webサービス実行のためのエクステンションの設定

Execute Pythonオペレータを含むプロセスをRapidMiner Server上のWebサービスとして実行したい場合は、以下の手順に従ってください。

1. RapidMiner StudioにPython Scriptingエクステンションがインストールされているとして、ホームフォルダ（通常はホームディレクトリ内の~/.RapidMinerフォルダで、Windowsの場合はC:\Users\your username\.RapidMiner\など）にあるStudioの設定ファイル（rapidminer-studio-settings.cfg）を探します。
2. 上記のファイルの rapidminer.python_scripting で始まるすべての設定を見つけ、Serverのデプロイメントに適用します（次のステップを参照）。
3. Webインタフェースまたは RapidMiner Serverデプロイメントで、Administration > System Settingsを開き、Python Scriptingに関する設定を追加してPythonインタプリタを定義します。StudioとServerが別のマシン上にある場合は、いくつかの設定（ファイルパスなど）を変更する必要があります。
4. すべての設定を追加したらSubmitをクリックします。例で、System Settingsタブは以下のようになります(以下のすべてのパラメータを定義する必要はないかもしれません)。
5. これらの変更を有効にするためにRapidMiner Serverを再起動します。

Pythonのインストール状況に応じて、以下の設定を1つまたは複数追加します。

• rapidminer.python_scripting.hidden.initialized
• rapidminer.python_scripting.package_manager
• rapidminer.python_scripting.conda_environment
• rapidminer.python_scripting.venvw_environment
• rapidminer.python_scripting.python_binary
• rapidminer.python_scripting.search_paths

Kerasエクステンションを使用する場合は、これらの（レガシー）設定も追加する必要があります。

• rapidminer.python_scripting.initialized
• rapidminer.python_scripting.path

通常のプロセス実行のためのエクステンションの設定

Execute Pythonオペレータを含むプロセスをRapidMiner Server上の通常のプロセスとして実行したい場合は、以下の手順に従ってください。

この章で説明した設定を、Serverデプロイメントのすべてのジョブエージェントに適用する必要があります。

1. {job-agent-home}/config/rapidminer/ディレクトリ内のrapidminer.propertiesファイルを編集します。{job-agent-home}は、ジョブエージェントのホームフォルダを意味します（通常、Serverをインストールしたホームにあります）。ファイルが存在しない場合は、ファイルを作成します。詳しくは、 ジョブエージェントのドキュメントをご覧ください。前の章で説明したのと同じプロパティを追加します。rapidminer.propertiesファイルは以下のようになっています。

2. RapidMiner Serverを再起動します。これでPython Scriptingエクステンションの設定が完了し、使用できるようになりました。

おわりに

接続されたRapidMiner StudioインスタンスにPython Scriptingエクステンションがインストールされている場合、これでExecute Pythonオペレータをもつプロセスを作成し、Serverデプロイメント上で実行できるようになりました。

また、Pythonコードから呼び出して、サーバー上のリソースを読み書きしたり、プロセスを実行したりできるようになりました。詳細については、 PythonからRapidMinerの呼び出しをご覧ください。

Execute Pythonオペレータは、前の章で定義されたPythonインタープリタの設定を、オペレータごとに上書きすることができることに留意してください。したがって、RapidMiner Studioで作成したプロセスをRapidMiner Serverで実行する場合は、オペレータのパラメータをいくつか変更する必要があります。

例：Execute Pythonオペレータでカスタムのconda環境を使用したい場合。これを行うには、”use default python”のチェックを外し、Studioのプロセスで環境を設定します。このプロセスをServer上で実行する際は、このカスタム環境がServerデプロイメントのすべてのジョブエージェント上に存在するか確認してください。