14.2.2 RPMインストールの使用

ダウンロードしたRPMファイルを実行して、Oracle Graph Serverをインストールできます。

Oracle Graph Server and Clientデプロイメントでは、Linuxのx86-64アーキテクチャとARMアーキテクチャの両方についてRPMファイルが提供されます。詳細は、「Oracle Graph Server and Clientのダウンロード」を参照してください。

親トピック: Oracle Graph Serverのインストール

14.2.2.1 Oracle Graph Serverのインストールの前提条件

RPMファイルを使用してグラフ・サーバーをインストールする前に、次の前提条件ステップを実行してください:
  1. 「Oracle Graph Serverをインストールするためのシステム要件」の説明に従って、システムの前提条件を満たしていることを確認します。
  2. 次のコマンドを実行して、グラフ・サーバーのインストール済バージョンがすでにあるかどうかを確認します:
    sudo rpm -q oracle-graph
[sudo] password for oracle: 
oracle-graph-25.1.0-0.x86_64

    インストールがすでに存在する場合は、グラフ・サーバーのインストールでエラーがスローされる可能性があります。その場合は、「Oracle Graph Serverのアップグレード」を参照して、新しいバージョンにアップグレードします。

親トピック: RPMインストールの使用

14.2.2.2 Oracle Graph Serverのインストール

Oracle Graph Serverをスタンドアロン・モードでインストールする場合のインストール・ステップは、次のとおりです。
  1. rootユーザーとして、またはsudoを使用して、RPMコマンドライン・ユーティリティによってRPMファイルをインストールします。
    • Linux x86-64の場合:
      sudo rpm -i oracle-graph-<version>.rpm
    • Linux ARMの場合:
      sudo rpm -i oracle-graph-<version>.aarch64.rpm

    前述のコマンドでは、<version>は、ダウンロードしたファイルのバージョンを示しています。(たとえば、oracle-graph-25.1.0.x86_64.rpmまたはoracle-graph-25.1.0.aarch64.rpm)

    .rpmファイルはグラフ・サーバーです。

    RPMファイルのインストール時には、次のインストール後のステップが実行されます。
  2. rootとして、またはsudoを使用して、サーバー・インストールの使用を許可されているオペレーティング・システム・ユーザーをオペレーティング・システム・グループoraclegraphに追加します。たとえば:
    usermod -a -G oraclegraph <graphuser>
    これによって、指定されたグラフ・ユーザーがグループoraclegraphに追加されます。

    この処理を有効にするには、<graphuser>がログアウトしてから再度ログインする必要があることに注意してください。

  3. <graphuser>として、データベース認証のためのグラフ・サーバーの準備のステップに従って/etc/oracle/graph下のファイルを変更し、サーバーを構成します。
    または、クイック設定スクリプトを使用してグラフ・サーバー(PGX)を簡単に構成することもできます。詳細は、「クイック設定スクリプトを使用したグラフ・サーバーの構成」を参照してください。
  4. ユーザーの認証および認可の説明に従って、グラフ・サーバーに接続するデータベース・ユーザーに対して認証が有効になっていることを確認します。
  5. rootユーザーとして、またはsudoを使用して、次のコマンドを実行することによりグラフ・サーバー(PGX)を起動します。
    sudo systemctl start pgx

    次のコマンドを実行すると、グラフ・サーバーが起動されているかどうかを確認できます:

    systemctl status pgx
    • グラフ・サーバーが正常に起動した場合、レスポンスは次のように表示されます。
      ● pgx.service - Oracle Graph In-Memory Server
   Loaded: loaded (/etc/systemd/system/pgx.service; disabled; vendor preset: disabled)
   Active: active (running) since Wed 2021-01-27 10:06:06 EST; 33s ago
 Main PID: 32127 (bash)
   CGroup: /system.slice/pgx.service
           ├─32127 /bin/bash start-server
           └─32176 java -Dlogback.configurationFile=/etc/oracle/graph/logback-server.xml -Doracle.jdbc.fanEnabled=false -cp /opt/oracle/graph/pgx/bin/../../pgx/server/lib/jackson-databind...

      これで、グラフ・サーバーでリクエストを受け入れる準備が整いました。

    • グラフ・サーバーが起動していない場合は、/var/log/oracle/graphにあるログ・ファイルでエラーを確認する必要があります。さらに、次のコマンドを実行して、systemdエラーを表示することもできます。
      sudo journalctl -u pgx.service

関連トピック

親トピック: RPMインストールの使用

14.2.2.3 クイック設定スクリプトを使用したグラフ・サーバーの構成

Graph Server and Clientリリース25.1以降では、quicksetup.shスクリプトを使用して初期グラフ・サーバー設定を構成できます。
  1. /opt/oracle/graph/scriptsに移動します。
  2. 必要なオプションを指定して./quicksetup.shスクリプトを実行することでグラフ・サーバーを設定します。
    このスクリプトを使用すると、グラフ・サーバーでTLSを有効または無効にできます。データベース認証に使用するJDBC URLを指定することもできます。

    次のパラメータがサポートされています。

    -j <jdbc_url> - Configure Oracle DB to be used by the Graph Server via JDBC URL
-d            - Setup will disable TLS accordingly on server configuration
-e            - Setup will enable TLS accordingly on server configuration
-u            - Setup will prompt for JDBC URL configuration
-q            - Enable quiet mode

    次の例では、前述のオプションの使用方法を示します:

    • グラフ・サーバー(PGX)でTLSを無効にするには:
      ./quicksetup.sh -d
    • グラフ・サーバー(PGX)で抑止モードを使用してTLSを有効にするには:
      ./quicksetup.sh -eq
    • プロンプトを使用してJDBC URLを構成するには:
      ./quicksetup.sh -u
Enter JDBC URL: jdbc:oracle:thin:@<host>:<port>/<sid>
    • パラメータとしてJDBC URLを使用してグラフ・サーバーを起動するには:
      ./quicksetup.sh -j jdbc:oracle:thin:@<host>:<port>/<sid>
    • TLSを無効にし、パラメータとしてJDBC URLを使用するには:
      ./quicksetup.sh -j jdbc:oracle:thin:@<host>:<port>/<sid> -d

親トピック: RPMインストールの使用

14.2.2.4 Oracle Graph Serverのアンインストール

グラフ・サーバーをアンインストールするには、グラフ・サーバーが停止していることを確認します。
  1. rootユーザーとして、またはsudoを使用して次のコマンドを実行します。
    sudo rpm -e oracle-graph
    • アンインストール時に、/opt/oracle/graph/pgx/tmp_data/および/etc/oracle/graph/server_keystore.jksが削除されます。

親トピック: RPMインストールの使用

14.2.2.5 Oracle Graph Serverのアップグレード

グラフ・サーバーをアップグレードするには、まず既存のグラフ・サーバー・バージョンを必ず停止します。その後、新しいRPMファイルを引数として指定して次のコマンドを実行できます。
  1. 現在のグラフ・サーバー・インストールのバージョンを確認します。
    sudo rpm -q oracle-graph
  2. グラフ・サーバーをすでに実行している場合はそれを停止します。
    sudo systemctl stop pgx
  3. rootユーザーまたはsudoで次のコマンドを実行してグラフ・サーバーをアップグレードします。
    • Linux x86-64の場合:
      sudo rpm -U oracle-graph-25.1.0.x86_64.rpm
    • Linux ARMの場合:
      sudo rpm -U oracle-graph-25.1.0.aarch64.rpm
    また、次の点にも注意してください。
    • アップグレード・プロセスでは、以前のPGX (PGX.conf)、サーバー(server.conf)およびロギング(logback-server.xml、logback.xml)構成ファイルが自動的に保持されます。ただし、新しいバージョンに変更が含まれている場合、アップグレード・プロセスでは、これらのファイルの最新バージョンが.rpmnew拡張子で作成されます。2つのファイルを比較して(デフォルトのパラメータ値に変更があるかどうか、または新しいパラメータが追加されているかどうかを確認するために)、最新の変更を選択できます。
    • PGXサービス(/etc/systemd/system/PGX.service)のsystemd構成ファイルでの手動での構成変更はすべて失われます。ただし、ドロップイン・ファイルを使用している場合は、ドロップイン・ファイル内のすべてのカスタマイズが維持されます。
    • /var/log/oracle/graph内の既存のログ・ファイルは保持されます。
    • 既存のサーバー・キーストア・ファイル(/etc/oracle/graph/server_keystore.jks)は保持されます。

      注意:

      グラフ・サーバーをバージョン22.3.0以前から25.1.0にアップグレードする場合は、Graph Server and Clientリリース25.1.0でのRPMファイル・インストールによって、デフォルトで、自己署名付きサーバー・キーストア・ファイルが生成されることに注意してください。詳細は、「トランスポート層セキュリティの設定」を参照してください。
  4. tmp_dataフォルダが/opt/oracle/graph/pgx/ディレクトリ・パスに存在するかどうかを確認します。

    存在しない場合は、次のように作成して所有権と権限を割り当てます:

    mkdir -p /opt/oracle/graph/pgx/tmp_data
chown -R :oraclegraph /opt/oracle/graph/pgx/tmp_data
chmod 0770 /opt/oracle/graph/pgx/tmp_data
  5. グラフ・サーバーを再起動します。
    sudo systemctl daemon-reload
sudo systemctl start pgx

親トピック: RPMインストールの使用