2.3. テンプレートベースのインストール環境での Oracle Database を使用した 3scale のアップグレード


本セクションでは、OpenShift 3.11 とテンプレートベースのインストール環境の組み合わせにおいて、Oracle Database で 3scale システムイメージを使用している場合に、Red Hat 3scale API Management をアップグレードする方法について説明します。

前提条件

Oracle Database を使用した 3scale インストール環境。Oracle Database を使用した 3scale システムイメージの設定 を参照してください。

テンプレートベースのインストール環境で Oracle Database を使用して 3scale のシステムイメージをアップグレードするには、以下の手順を実行します。

2.3.1. Oracle 19c を使用した 3scale のアップグレード

以下の手順では、Oracle Database 19c の更新、既存の 3scale 2.11 インストール環境から 3scale 2.12 への変更について説明します。

重要:データベースへの接続が失われると、3scale が破損する可能性があります。アップグレードを進める前にバックアップを作成します。詳細については、Oracle データベースのドキュメントを参照してください。Oracle Database Backup and Recovery User's Guideを参照してください。

前提条件

  • 3scale 2.11 のインストール
  • Oracle Database 19c のインストール

手順

  1. GitHub リポジトリーから 3scale OpenShift テンプレートをダウンロードし、アーカイブをデプロイメントします。

    tar -xzf 3scale-amp-openshift-templates-3scale-2.12.0-GA.tar.gz
    Copy to Clipboard Toggle word wrap
  2. Oracle Database の Instant Client パッケージファイルを 3scale-amp-openshift-templates-3scale-2.12.0-GA/amp/system-oracle/oracle-client-files ディレクトリーに配置します。
  3. -f オプションで build.yml OpenShift テンプレートを指定して、oc process コマンドを実行します。

    $ oc process -f build.yml | oc apply -f -
    Copy to Clipboard Toggle word wrap
  4. -f オプションで amp.yml OpenShift テンプレートを指定し、-p オプションで WILDCARD_DOMAIN パラメーターに OpenShift クラスターのドメインを指定して、oc new-app コマンドを実行します。

    $ oc new-app -f amp.yml -p WILDCARD_DOMAIN=mydomain.com
    Copy to Clipboard Toggle word wrap
    注記

    以下の手順は任意です。インストール後やシステムアップグレード後にORACLE_SYSTEM_PASSWORDを削除する場合に使用します。

  5. 以下の oc patch コマンドを入力します。SYSTEM_PASSWORDOracle Database の準備 で設定した Oracle Database の system パスワードに置き換えます。

    $ oc patch dc/system-app -p '[{"op": "add", "path": "/spec/strategy/rollingParams/pre/execNewPod/env/-", "value": {"name": "ORACLE_SYSTEM_PASSWORD", "value": "SYSTEM_PASSWORD"}}]' --type=json
    
    $ oc patch dc/system-app -p '{"spec": {"strategy": {"rollingParams": {"post":{"execNewPod": {"env": [{"name": "ORACLE_SYSTEM_PASSWORD", "value": "SYSTEM_PASSWORD"}]}}}}}}'
    Copy to Clipboard Toggle word wrap
  6. 以下のコマンドを入力します。DATABASE_URLOracle Database の準備で指定した Oracle Database を参照するように置き換えます。

    $ oc patch secret/system-database -p '{"stringData": {"URL": "DATABASE_URL"}}'
    Copy to Clipboard Toggle word wrap
  7. oc start-build コマンドを入力し、新しいシステムイメージをビルドします。

    $ oc start-build 3scale-amp-system-oracle --from-dir=.
    Copy to Clipboard Toggle word wrap
  8. ビルドが完了するまで待ちます。ビルドの状態を確認するには、以下のコマンドを実行します。

    $ oc get build <build-name> -o jsonpath="{.status.phase}"
    Copy to Clipboard Toggle word wrap
    1. ビルドが Complete の状態になるまで待ちます。
  9. Oracle Database で 3scale システムイメージを設定したら、system-app DeploymentConfig から ORACLE_SYSTEM_PASSWORD を削除します。新しいバージョンの 3scale にアップグレードするまで再度削除する必要はありません。

    $ oc set env dc/system-app ORACLE_SYSTEM_PASSWORD-
    Copy to Clipboard Toggle word wrap

open_cursors パラメーター設定の検証

このデータベースの open_cursors パラメーターが 1000 より大きい値に設定されていることを確認する必要があります。

これを行うには、SYSTEM ユーザーとして Oracle Database にログインし、次のコマンドを実行します。

show parameter open_cursors;
Copy to Clipboard Toggle word wrap

戻り値は少なくとも 1000 である必要があります。そうでない場合は、open cursors に関する次の Oracle のドキュメントに従って、パラメーターを 1000 より大きい値に変更します。

open_cursors パラメーターが以前に 1000 未満の制限に設定されていて、値を増加させなかった場合は、OpenShift の system-app Pod ログの 1 つに次のエラーが表示される場合があります。

ORA-01000: maximum open cursors exceeded
Copy to Clipboard Toggle word wrap

関連情報

3scale と Oracle Database のサポートについては、Red Hat 3scale API Management のサポート対象設定 を参照してください。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat