1. インストレーションおよび管理ガイド
  2. Oracle Machine Learning for Rサーバーのインストール

4 Oracle Machine Learning for Rサーバーのインストール

この章では、OML4Rサーバーのインストール方法および管理方法について説明します。この章の内容は、次のとおりです。

関連項目

4.1 Oracle Machine Learning for Rサーバーについて

OML4Rには、OML4RクライアントとOML4Rサーバーとの相互作用を可能にするOracle Databaseサーバー上のコンポーネントが含まれています。

ノート:

OML4Rのバージョンは、サーバーと各クライアント・コンピュータで同じである必要があります。また、Rのバージョンは、サーバーと各クライアント・コンピュータで同じである必要があります。

次のコンポーネントがあります。

  • Oracle R Distributionまたはオープン・ソースR

  • OML4Rサーバー

    • RQSYSスキーマ

    • sys内のメタデータおよび実行可能コード

    • OML4Rサーバー・ライブラリ(LinuxおよびUNIXの場合は$ORACLE_HOME/lib内、Windowsの場合は%ORACLE_HOME%\bin内)

    • $ORACLE_HOME/R/library (Windowsの場合は%ORACLE_HOME%\R\library)内のOML4Rパッケージ

      サーバーのOML4RパッケージおよびSupporting Packagesでは、埋込みRの実行がサポートされています。これと同じパッケージを各クライアント・コンピュータに個別にインストールする必要があります(OML4Rパッケージについてを参照してください)。

詳細は、次のトピックを参照してください。

関連項目:

  • サポートされているRおよびOML4Rのバージョンのリストは、表1-4を参照してください。
  • OML4Rのサーバー・コンポーネントとクライアント・コンポーネントについては、図1-2を参照してください。

親トピック: Oracle Machine Learning for Rサーバーのインストール

4.1.1 RQSYSスキーマについて

RQSYSスキーマは、Oracle DatabaseでのOracle Machine Learning for Rのシステム・アカウントです。

これには、メタデータ、PL/SQLパッケージ、およびOML4Rサーバーの内部で使用される他の実行可能コードが含まれています。

OML4Rサーバー・インストール・プロセスでは、パスワードが期限切れになってロックされたアカウントとしてRQSYSが作成されます。rqsysユーザーにはCREATE SESSION権限がありません。

親トピック: Oracle Machine Learning for Rサーバーについて

4.1.2 OML4Rのセキュリティのベスト・プラクティス

Oracle DatabaseでOML4Rサーバーのセキュリティを損なうリスクを最小化するために、次のセキュリティのベスト・プラクティスをお薦めします。

Oracle DatabaseインスタンスのOML4Rサーバー・コンポーネントには、ロックされてパスワードが期限切れになったRQSYSスキーマ(OML4Rメタデータを格納および管理する)が含まれます。ユーザーは、データベースの接続資格証明を使用してOML4Rサーバーに接続します。RQADMINロールによって、OML4R Rスクリプト・リポジトリでR関数をスクリプトとして作成する権限がユーザーに付与されます。これらのスクリプトは、OML4Rの埋込みRの実行を使用して実行できます。

次のセキュリティのベスト・プラクティスをお薦めします。

  • RQSYSスキーマをロック解除したり、ログインを有効にしないでください。

  • RQADMINロールは、Rスクリプト・リポジトリを作成および管理するデータベース・ユーザーにのみ付与します。

  • プライベートRスクリプトを作成し、必要に応じて他のユーザーにアクセス権を付与します。グローバルRスクリプトは、すべてのOML4Rユーザーが表示し、実行できます。

  • パラメータまたはOML4Rデータストアを使用して、埋込みRの実行スクリプトとOracle Databaseの間でデータを転送します。Rスクリプトは、サーバーのファイル・システムやネットワークとやり取りしないでください。

  • Oracle Databaseサーバーのリソースおよび使用パターンに基づいて、OML4Rの埋込みRの実行メモリー制限を適切に設定します。デフォルト値は、1接続当たり2 GBです。

  • 埋込みRの実行を使用するRスクリプトでOracle Databaseサーバーに接続する際に、明示的なデータベース資格証明を指定するかわりに、自動接続機能(connect=TRUE)を使用します。

  • 承認されていないRパッケージまたはCライブラリを、埋込みRの実行で使用するためにOracle Databaseサーバーにロードすることを許可しないでください。

  • 依存する共有ライブラリを$ORACLE_HOME/libディレクトリからロードして、承認されていないライブラリの使用を防ぎます。

関連項目

親トピック: Oracle Machine Learning for Rサーバーについて

4.2 Oracle Machine Learning for Rサーバーの要件

OML4Rサーバーをインストールする前に、システム環境を確認し、ユーザーIDに正しい権限があることを確認してください。

OML4Rサーバーの前提条件として、Oracle Databaseと、Oracle R Distributionまたはオープン・ソースRがインストールされている必要があります。

  • システム要件
    OML4Rサーバーのシステム要件を示します。
  • 環境変数
    OML4Rサーバーに必要な環境変数を示します。
  • ユーザー要件
    OML4Rサーバーをインストールするオペレーティング・システム・ユーザーの要件を示します。

関連項目

親トピック: Oracle Machine Learning for Rサーバーのインストール

4.2.1 システム要件

OML4Rサーバーのシステム要件を示します。

親トピック: Oracle Machine Learning for Rサーバーの要件

4.2.2 環境変数

OML4Rサーバーに必要な環境変数を示します。

表4-1 Oracle Machine Learning for Rサーバーの環境変数要件

プラットフォーム 環境変数要件

すべて

$ORACLE_SIDで、OML4Rをサポートするデータベースのサービス識別子(SID)が指定されている必要があります。

$ORACLE_HOMEで、ORACLE_SIDによって識別されるデータベースのホーム・ディレクトリが指定されている必要があります。

Windowsでは、OracleホームおよびOracleインスタンス識別子の値はWindowsレジストリで確認できます。このコンピュータ上に2つ以上のOracleホームまたはOracleインスタンスが存在する場合は、環境変数で必要な値を指定できます。Windowsでの環境変数の作成および変更を参照してください。

Linux

$LD_LIBRARY_PATHに$ORACLE_HOME/libが含まれている必要があります。

$PATHに$ORACLE_HOME/binが含まれている必要があります。

Oracle Solaris

$LD_LIBRARY_PATHに$ORACLE_HOME/libが含まれている必要があります。

$PATHに$ORACLE_HOME/binが含まれている必要があります。

IBM AIX

$LIBPATHに$ORACLE_HOME/libが含まれている必要があります。

$PATHに$ORACLE_HOME/binが含まれている必要があります。

Microsoft Windows

%PATH%に%R_HOME%\bin\x64が含まれている必要があります。%R_HOME%のデフォルト値は、C:\Program Files\R\R-3.6.1です。

Rホーム・ディレクトリの値はWindowsレジストリで確認できます。このコンピュータ上に2つ以上のRホームが存在する場合は、環境変数で必要な値を指定できます。Windowsでの環境変数の作成および変更を参照してください。

親トピック: Oracle Machine Learning for Rサーバーの要件

4.2.3 ユーザー要件

OML4Rサーバーをインストールするオペレーティング・システム・ユーザーの要件を示します。

表4-2 OML4Rサーバーのインストーラのユーザー要件

プラットフォーム ユーザー要件

LinuxおよびUNIX

  • dbaグループのメンバーである必要があります。

  • $ORACLE_HOME/libへの書込み権限が必要です。

Microsoft Windows

  • 管理者のアクセス権が必要です。

  • ora_dbaグループのメンバーである必要があります。

  • %ORACLE_HOME%\binへの書込みアクセス権があります。

詳細は、次のトピックを参照してください。

親トピック: Oracle Machine Learning for Rサーバーの要件

4.2.3.1 オペレーティング・システム認証について

OML4Rサーバーで使用されるオペレーティング・システム認証について説明します。

OML4Rサーバーのインストール・スクリプトでは、ORACLE_HOMEおよびORACLE_SIDによって識別されるデータベースへの接続にシステム認証が使用されます。システム認証は、データベース資格証明書ではなくユーザーのオペレーティング・システム資格証明書に基づいています。

たとえば、Linuxシステムでは、OML4Rのインストール・スクリプトで、次の文を使用してパスワードなしでSQL*Plusが起動されます。 

$ORACLE_HOME/bin/sqlplus / as sysdba

特別なオペレーティング・システム・グループのメンバーシップによって、Oracle Databaseのシステム認証が行われます。このオペレーティング・システム・グループは、データベースのインストール時に作成され、インストール実行者のIDがグループに自動的に割り当てられます。グループの一般的な名前はOSDBAです。LinuxおよびUNIXでは、OSDBAの名称はdbaです。Windowsでは、OSDBAの名称はora_dbaです。

OML4RサーバーをインストールするユーザーはOSDBAに属している必要があります。

関連項目:

親トピック: ユーザー要件

4.2.3.2 ユーザーIDのグループ・メンバーシップの確認

OML4Rサーバーに必要なグループ・メンバーシップを決定する方法について説明します。

オペレーティング・システム認証についてで説明しているように、OML4Rサーバーのインストール・スクリプトを実行するLinuxまたはUNIXユーザーIDは、dbaグループに属している必要があります。サーバー上でその他のOML4Rスクリプトを実行するには、dbaグループのメンバーシップも必要です。Windowsでは、dbaグループはora_dbaと呼ばれます。

ご使用のLinuxまたはUNIXのユーザーIDのグループ・メンバーシップを確認するには、次のコマンドを入力します。

% groups
dba  othergroup

ご使用のWindowsのユーザーIDのグループ・メンバーシップを確認するには:

  1. Windowsの「コントロール パネル」を開きます。
  2. 「ユーザー アカウント」を選択します。
  3. 「ユーザー アカウントの管理」を選択します。
  4. 「ユーザー アカウント」ダイアログの「ユーザー」タブには、名前、ドメインおよび各ユーザー・アカウントのグループがリストされています。ご使用のIDがグループora_dbaに属していることを確認します。

親トピック: ユーザー要件

4.3 Oracle Database 19c以降の場合のOracle Machine Learning for Rサーバーのインストール

Oracle Database 19c以降のOML4Rサーバーのインストール手順。

rqcfg.sqlスクリプトは、データベースの一部であるOML4R Serverコンポーネントを有効にし、サーバーのいくつかの側面を構成し、一部のOML4Rデータベース・オブジェクトをインストールします。

OML4Rサーバーをインストールする前に、Oracle Machine Learning for Rのインストールの説明に従ってRをインストールします。

R-4.0.5と使用する場合、OML4Rサーバー・パッケージは、個別の各Rバージョンに基づいて構築されています。OML4RをR-4.0.5と使用するには、それらのOML4Rサーバー・パッケージをダウンロードしインストールする必要があります。

親トピック: Oracle Machine Learning for Rサーバーのインストール

4.3.1 R-3.6.1以降でOML4R Serverを使用するための準備

R-3.6.1の下でビルドされたOML4R Serverパッケージをダウンロードしてインストールする手順。

Oracle Database 18cおよび19cでは、OML4R Serverパッケージは$ORACLE_HOME/R/library/ディレクトリにあります。R-3.6.1以降と使用する場合は、そのディレクトリ内のOML4Rパッケージの名前を変更するか、それらを削除することができます。その後、使用しているRバージョンと互換性のあるOML4Rサーバー・パッケージをダウンロードしインストールします。

次の手順では、元のOML4Rサーバー・パッケージの名前を変更し、R-4.0.5に基づいて構築されているパッケージに置き換えます。
  1. $ORACLE_HOME/R/library/ディレクトリにあるOML4Rパッケージの名前を変更します。
    $ cd $ORACLE_HOME/R/library

$ mv ORE ORE.orig
$ mv OREbase OREbase.orig
$ mv OREcommon OREcommon.orig
$ mv OREdm OREdm.orig
$ mv OREdplyr OREdplyr.orig
$ mv OREeda OREeda.orig
$ mv OREembed OREembed.orig
$ mv OREgraphics OREgraphics.orig
$ mv OREmodels OREmodels.orig
$ mv OREpredict OREpredict.orig
$ mv OREserver OREserver.orig
$ mv OREstats OREstats.orig
$ mv ORExml ORExml.orig
  2. Oracle Machine Learning for Rダウンロード・ページに移動し、ライセンス契約に同意し、R-4.0.5互換のOML4Rサーバー・パッケージをインストール・ディレクトリ(/oml4rserver_install_dir/など)にダウンロードします。

    ノート:

    すべてのOML4Rコンポーネントで、同じインストール・ディレクトリを使用します。
  3. インストール・ディレクトリに移動し、ダウンロードしたファイルを解凍します。
    $ cd /oml4rserver_install_dir/
$ unzip ore-server-platform-arch-version.zip

    ファイルの解凍時に/serverディレクトリが作成され、次のファイルがそこに抽出されます。 

    /server/ORE_version_R_arch-unknown-platform-gnu.tar.gz
/server/OREbase_version_R_arch-unknown-platform-gnu.tar.gz
/server/OREcommon_version_R_arch-unknown-platform-gnu.tar.gz
/server/OREdm_version_R_arch-unknown-platform-gnu.tar.gz
/server/OREdplyr_version_R_arch-unknown-platform-gnu.tar.gz
/server/OREeda_version_R_arch-unknown-platform-gnu.tar.gz
/server/OREembed_version_R_arch-unknown-platform-gnu.tar.gz
/server/OREgraphics_version_R_arch-unknown-platform-gnu.tar.gz
/server/OREmodels_version_R_arch-unknown-platform-gnu.tar.gz
/server/OREpredict_version_R_arch-unknown-platform-gnu.tar.gz
/server/OREserver_version_R_arch-unknown-platform-gnu.tar.gz
/server/OREstats_version_R_arch-unknown-platform-gnu.tar.gz
/server/ORExml_version_R_arch-unknown-platform-gnu.tar.gz
  4. /oml4rserver_install_dir/serverディレクトリに移動し、次のコマンドを実行します。
    $ cd /oml4rserver_install_dir/server

$ ORE CMD INSTALL ORE_version_R_arch-unknown-platform-gnu.tar.gz
$ ORE CMD INSTALL OREbase_version_R_arch-unknown-platform-gnu.tar.gz
$ ORE CMD INSTALL OREcommon_version_R_arch-unknown-platform-gnu.tar.gz
$ ORE CMD INSTALL OREdm_version_R_arch-unknown-platform-gnu.tar.gz
$ ORE CMD INSTALL OREdplyr_version_R_arch-unknown-platform-gnu.tar.gz
$ ORE CMD INSTALL OREeda_version_R_arch-unknown-platform-gnu.tar.gz
$ ORE CMD INSTALL OREembed_version_R_arch-unknown-platform-gnu.tar.gz
$ ORE CMD INSTALL OREgraphics_version_R_arch-unknown-platform-gnu.tar.gz
$ ORE CMD INSTALL OREmodels_version_R_arch-unknown-platform-gnu.tar.gz
$ ORE CMD INSTALL OREpredict_version_R_arch-unknown-platform-gnu.tar.gz
$ ORE CMD INSTALL OREstats_version_R_arch-unknown-platform-gnu.tar.gz
$ ORE CMD INSTALL OREserver_version_R_arch-unknown-platform-gnu.tar.gz
$ ORE CMD INSTALL ORExml_version_R_arch-unknown-platform-gnu.tar.gz
OML4Rサーバーを初めてインストールする場合は、rqcfg.sqlスクリプトを実行します。OML4Rサーバーをすでにインストールしてあり、Rをアップグレードする場合は、rqcfg.sqlスクリプトの実行は必要はありません。

親トピック: Oracle Database 19c以降の場合のOracle Machine Learning for Rサーバーのインストール

4.3.2 rqcfg.sqlを使用したOML4Rサーバーのインストール

Oracle Database 19c以降のOML4Rサーバーのインストール手順。

Rをインストールした後、 /oml4rserver_install_dir/server/rqcfg.sqlスクリプトを実行し、次の表にある引数の値を指定することで、OML4Rサーバーをインストールします。

表4-3 rqcfg.sqlインストール・スクリプトへの引数

引数 説明

define permtbl

RQSYSスキーマの永続表領域を指定します。

define temptbl

一時表領域を指定します。

define orahome

ORACLE_HOMEディレクトリを指定します。

define rhome

R_HOMEディレクトリを指定します。

  1. オペレーティング・システム・プロンプトで、SQL*Plusを起動し、PDBに直接ログインしてrqcfg.sqlスクリプトを実行します。ログを取得するために、インストール・ステップを外部ファイルにスプールします。次の例では、PDB PDB1を使用し、スクリプト引数のサンプル値を指定します。
    $ sqlplus / as sysdba 
SQL> spool install.txt 
SQL> alter session set container=PDB1; 
...for your system and R version...
SQL> define permtbl = SYSAUX
SQL> define temptbl = TEMP
SQL> define orahome = /u01/app/oracle/product/21.3.0.0/dbhome_1
SQL> define rhome = /usr/lib64/R
SQL> @/oml4rserver_install_dir/server/rqcfg.sql &permtbl &temptbl &orahome
    &rhome

    install.txtファイルを開き、エラーが発生したかどうかを確認します。

  2. オペレーティング・システムのプロンプトで、ORACLE_HOME/binディレクトリの下にOREスクリプトを作成し、それを実行可能にします。次のコマンドを実行する前に、環境変数ORACLE_HOMEおよびR_HOMEが正しく設定されていることを確認する必要があります。
    $ cat >$ORACLE_HOME/bin/ORE <<EOF
#!/bin/sh
R_LIBS_USER="$ORACLE_HOME/R/library"
export R_LIBS_USER
$R_HOME/bin/R \$@
EOF
$ chmod +x $ORACLE_HOME/bin/ORE
  3. OML4R Supporting Packagesのインストールの説明に従って、システムに適したOML4R 2.0 Supporting Packagesをダウンロードしてインストールします

関連項目

親トピック: Oracle Database 19c以降の場合のOracle Machine Learning for Rサーバーのインストール

4.4 Oracle Database 12c以前のOracle Machine Learning for Rサーバーのインストール

Oracle Database 12c以前のOML4Rサーバーのインストール手順。

ノート:

表示されるプロンプトに応答する必要なくOML4Rサーバーをインストールするには、デフォルトのバッチ・インストールで説明されているようなバッチ・モード・インストールを使用します。

OML4Rサーバーをインストールするには:

  1. システムがOracle Machine Learning for Rサーバーの要件で指定されている要件を満たしていることを確認します。

  2. OML4R Serverコンポーネントのインストール・ディレクトリを作成します。ディレクトリには任意の名前を使用できます。次に例を示します。 

    /oml4r_server_install_dir

  3. Oracle Technology NetworkのOracle Machine Learning for R Downloadsページから、OML4Rサーバー・インストール・ファイルおよびSupporting Packagesをダウンロードします。

    1. ライセンス契約に同意して、ご使用のプラットフォーム用のOML4R Serverファイルをインストール・ディレクトリにダウンロードします。

    2. ライセンス契約に同意して、ご使用のプラットフォーム用のOML4R Supporting Packagesをインストール・ディレクトリにダウンロードします。

    インストール・ディレクトリに2つのzipファイルが配置されます。 

    ore-server-platform-arch-version.zip
ore-supporting-platform-arch-version.zip

  4. これらのファイルを解凍します。

    unzip ore-server-platform-arch-version.zip
unzip ore-supporting-platform-arch-version.zip

    両方のファイルを解凍した後のインストール・ディレクトリは次のようになります。

    LinuxまたはUNIXの場合:

    /oml4r_server_install_dir
     ore-server-platform-arch-version.zip
     ore-supporting-platform-arch-version.zip
     server.sh
     /server
     /supporting

    Windowsの場合:

    \oml4r_server_install_dir
     ore-server-platform-arch-version.zip
     ore-supporting-platform-arch-version.zip
     server.bat
     \server
     \supporting

  5. LinuxまたはUNIXの場合は、server.shを実行します。Windowsの場合は、server.batを実行します。デフォルトのインタラクティブ・インストールで説明したように、スクリプトによってOML4Rサーバーのデフォルトの初回インストールが実行されます。serverスクリプトの詳細は、serverスクリプトについてを参照してください。

    LinuxまたはUNIXの場合:

    ./server.sh

    Windowsの場合:

    server.bat

ノート:

R-3.3.0以降では、Oracle Linux 6システムの場合、$ORACLE_HOME/hs/admin/extproc.oraのLD_LIBRARY_PATHをR-core-extra RPMの場所に設定する必要があります。これにより、これらのライブラリは、extprocを実行中のOracleプロセスに検出されます。Linuxシステムでは、R-core-extra RPMのデフォルトの場所は/usr/lib64/R/port/Linux-X64/libです。extproc.oraで、次のように入力します。

SET LD_LIBRARY_PATH=/usr/lib64/R/port/Linux-X64/lib

extproc.oraの変更を有効にするには、データベースの停止と再起動が必要であることに注意してください。

この手順はLinux 7システムでは必要ありません。R-core-extra RPMで提供される必要なバージョンのライブラリは、ネイティブで使用可能です。

関連項目:

出力付きの例については、例A-1

R-core-extra RPMについて

Rは、様々なサード・パーティのライブラリ、zlib、bzip2、xz、pcreおよびcurlに常に依存します。R-3.3.0より前では、Rは古いバージョンのライブラリに依存し、これらがシステムにない場合でも、同梱されたコピーがオンザフライで構築されて含まれていました。

R-3.3.0は、新しいバージョンのこれらのライブラリに依存し、同梱されたコピーは含まれていません。つまり、これらのライブラリのネイティブ・バージョンがR-3.3.0で必要なものよりも古いため、R-3.3.0がLinux6に対してそのままビルドされないことを意味します。

R-core-extraのRPMには、これらのライブラリの必要なバージョンが含まれ、便宜上、Oracle Linux 6のユーザーのために提供されます。R-core-extraのライブラリの場所をLD_LIBRARY_PATHに追加すると、これらのライブラリを個別に構築する必要がありません。Oracle Linux 7以降には、これらのライブラリの必要なバージョンが含まれているため、R-core-extra RPMは不要です。

次のトピックでは、Oracle Database 12c以前のOML4R Serverスクリプトについて説明します。

  • serverスクリプトについて
    serverという1つのスクリプトによって、Oracle Database 12c以前のリリースのOML4Rサーバーのインストールおよび管理が管理されます。

親トピック: Oracle Machine Learning for Rサーバーのインストール

4.4.1 serverスクリプトについて

serverという1つのスクリプトによって、Oracle Database 12c以前のリリースのOML4Rサーバーのインストールおよび管理が管理されます。

OML4Rのサーバー側コンポーネントのインストール、アンインストール、アップグレードまたは構成が必要になったときにはいつでも、serverスクリプトを再実行できます。

次の各トピックでは、スクリプトについて詳しく説明しています。

親トピック: Oracle Database 12c以前のOracle Machine Learning for Rサーバーのインストール

4.4.1.1 serverスクリプト操作の概要

server.sh(.bat)スクリプトで実行できる操作について説明します。

server.sh(.bat)スクリプトでは、次の操作がサポートされています。

  • OML4Rサーバーのインストール

  • OML4Rサーバーのアンインストール

  • OML4Rサーバーのアップグレードおよび旧インストールからのデータの移行

  • Supporting Packagesのインストール(使用可能な場合)

  • データベース・ユーザーの作成または構成(存在しない場合)

ノート:

server.sh(.bat)スクリプトを使用すると、Supporting Packagesをインストールできます。または、次の項で説明するように、これらのタスクを別々に実行することもできます。

4.4.1.2 serverスクリプトの構文

server.sh(.bat)スクリプトでは、そのアクティビティを指示する一連のコマンドライン引数がサポートされています。

スクリプトは、インタラクティブ・モード、バッチ・モードまたはハイブリッド・モードで実行できます。引数なしでスクリプトを実行すると、OML4Rサーバーがインタラクティブ・モードでインストールまたはアップグレードされ、Supporting Packagesのインストールが試行されて、データベース・ユーザーが作成または構成されます。

server.sh(.bat)スクリプトのコマンドライン引数については、次の表で説明しています。スクリプトの引数は、Linux、UNIXおよびWindowsで同じです。LinuxまたはUNIXシステムで次のコマンドを実行すると、引数のリストおよび短い説明が表示されます。 

./server.sh -h
or
./server.sh --help

Windowsシステムで次のコマンドを実行すると、引数のリストおよび短い説明が表示されます。

server.bat -h
or
server.bat --help

表4-4 serverスクリプトのコマンドライン引数

引数 説明

-i、--install

OML4Rサーバーをインストールまたはアップグレードします。

インストールまたはアップグレードでは、デフォルトで次の処理が行われます。

  • Supporting Packagesのインストール(存在する場合)。

  • データベース・ユーザーの作成または構成(存在しない場合)。

-u、--uninstall

OML4Rサーバーをアンインストールします。

  • --keep (デフォルト)を使用した場合、RQSYSメタデータおよびPL/SQLパッケージはデータベースから削除されますが、OracleホームのライブラリおよびRパッケージは保持されます(部分アンインストール)。

  • --fullを使用した場合、OracleホームのライブラリおよびRパッケージも、データベース内のRQSYSメタデータおよびPL/SQLパッケージも削除されます(完全アンインストール)。

Oracle Machine Learning for Rのアンインストールを参照してください。

-y

プロンプトを表示しません。

--ask

インタラクティブ・モード(デフォルト)。

--keep

OML4Rサーバーをアンインストールするときに、OracleホームのRパッケージおよびライブラリは保持しますが、データベース・オブジェクトは削除します。Oracleホーム内の他のデータベースに影響を与えることなく、単一データベース・インスタンスまたはプラガブル・データベース(PDB)からOML4Rのサポートを削除できます。

「部分アンインストールの実行」を参照してください。

--full

OML4Rサーバーをアンインストールするときに、OracleホームのRパッケージおよびライブラリも、データベース・オブジェクトも削除します。

「完全アンインストールの実行」を参照してください。

--no-supp

--installと組み合せて指定した場合、Supporting Packagesはインストールされません。デフォルトでは、使用可能なSupporting Packagesがあればインストールされます。

--supp

Supporting Packagesをインストールします(デフォルト)。

--no-db

no-dbを指定した場合、データベースは構成されません。埋込みRの実行に関連付けられているOREモジュールおよびライブラリのみがインストールされます。

--pdb NAME

マルチテナントのコンテナ・データベース(CDB)内のプラガブル・データベース(PDB)の名前。

マルチテナント・アーキテクチャを使用すると、Oracle Databaseを、0、1または多数のプラガブル・データベース(PDB)を含むプラガブル・データベースを含むコンテナ・データベースとして機能させることができます。マルチテナント・アーキテクチャの詳細は、『Oracle Database概要』を参照してください。

--perm PERM

RQSYSの永続表領域。

--temp TEMP

RQSYSの一時表領域。
4.4.1.3 serverスクリプトの例

serverスクリプトの使用例。

serverスクリプトの使用例は、次のトピックを参照してください。

関連項目:

出力付きの例については、例A-1

親トピック: serverスクリプトについて

4.4.1.3.1 デフォルトのインタラクティブ・インストール

OML4Rサーバーのデフォルト・インストールの例。

ご使用のLinuxまたはUNIXシステムが、「システム要件」で示されている要件を満たしている場合は、このコマンドによりOML4Rサーバーのデフォルトの初回インストールが実行されます。

LinuxまたはUNIXの場合:

./server.sh

例A-1に示すとおり、デフォルトのインタラクティブ・インストールでは次の処理が実行されます。

  • 環境の情報が出力されます。

  • パスワードとrqsysの永続表領域および一時表領域の入力を求めるプロンプトが表示されます。

  • Supporting Packagesをインストールするかどうか確認するプロンプトが表示されます。(デフォルトでは、Supporting Packagesが使用可能な場合はインストールされます。)

  • OML4Rのユーザー・アカウントを作成するかどうか確認するプロンプトが表示されます。(デフォルトでは、ユーザーが存在しない場合は作成されます。)ユーザーの作成時に、永続表領域および一時表領域の入力を求めるプロンプトが表示されます。

親トピック: serverスクリプトの例

4.4.1.3.2 デフォルトのバッチ・インストール

OML4Rサーバーのバッチ・モードでのインストールの例。

この例では、バッチ・モードで実行するよう指定された、デフォルトのインタラクティブ・インストールで示されているようなインストールを示します。

LinuxまたはUNIXの場合:

./server.sh  -y  --install  --setup-user  --perm SYSAUX  --temp TEMP  
          --user-perm USERS  --user-temp TEMP  --user OML_USER

親トピック: serverスクリプトの例

4.5 OML4Rサーバーのインストールの検証

server.shスクリプトを使用して、OML4RサーバーがOracle Database 12c以前に正常にインストールされたことを検証するには、ログ・ファイルを表示します。Oracle Database 18c以降のインストールでは、SQLスクリプトrqcfg.sqlは発生したエラーを返します。

どのインストールでも、いくつかの関数を実行して、正常にインストールされたことを確認できます。

12c以前の場合、ログ・ファイルを表示

OML4Rサーバー・インストール・スクリプトserver.shによって、インストール・ディレクトリのserverサブディレクトリにログ・ファイルが作成されます。ログ・ファイルを調べて、インストール・プロセスが正常に終了していることを確認します。

LinuxまたはUNIXシステムでは、次のコマンドでログ・ファイルがリストされます。

cd ./oml4r_server_install_dir/server
ls *.log
outcdb.log  rqconfig.log  rqdrop.log  rqgrant.log  rqinst.log  rqpdrp.log  rqproc.log  rquser.log

インストールに問題があり、解決できない場合は、My Oracle SupportまたはData WarehousingのR Technologiesで助力を求めることができます。

例4-1 サーバーのインストールを検証する実行例

まず、これらのコマンドをデータベース・サーバー上でRインスタンスから直接実行し、次にOML4Rクライアントから実行します。

OREスクリプトを使用してRを起動し、OREライブラリをロードします。 

% ORE
> library(ORE)

サーバーに接続します。この例では、ユーザーOML_USERとして接続します。

ore.connect("OML_USER", password="OML_USERpsw", conn_string="", all=TRUE)

いくつかの関数を実行します。

## Is the OML4R client connected to the OML4R server?
## The output of this function should be TRUE.
ore.is.connected()

## List the available database tables.
ore.ls()

## Push an R dataframe to a database table.
df <- data.frame(a="abc",
                b=1.456,
                c=TRUE,
                d=as.integer(1))
of <- ore.push(df)

## Run the self-contained example code in the help files associated with 
## the following functions.
example("ore.glm")       ## Builds an OML4R generalized linear model.
example("ore.stepwise")  ## Builds an OML4R stepwise least squares regression model.
example("ore.odmAI")     ## Builds an OML4SQL attribute importance model.
example("ore.doEval")    ## Runs an embedded R execution function.

関連項目

親トピック: Oracle Machine Learning for Rサーバーのインストール

4.6 マルチテナント環境へのOML4Rサーバーのインストール

マルチテナント環境へのOML4Rサーバーのインストールに関する情報。

OML4Rサーバーは、マルチテナント環境内の1つ以上のプラガブル・データベース(PDB)にインストールできます。OML4Rサーバーは、ルート・データベースではなくプラガブル・データベースにインストールする必要があります。

OML4Rサーバーの複数のインスタンスをマルチテナント・コンテナ・データベース(CDB)にインストールした場合に、1つのインスタンスをアンインストールしてその他を保持するには、部分アンインストールの実行で説明する部分アンインストールを実行できます。

関連項目:

親トピック: Oracle Machine Learning for Rサーバーのインストール