Oracle Forms 14.1.2.0.0へのアップグレード

ソフトウェアを同じOracleホーム・ディレクトリ・パス(インプレース)にインストールするか、新しいOracleホーム・ディレクトリ・パス(アウトオブプレース)にインストールして、Oracle Forms 14.1.2.0.0にアップグレードします。アップグレード後、該当する構成ステップを完了します。

アウトオブプレース・メソッドを使用する必要がある場合もありますが、通常はお薦めしません。一部の構成ファイルは、再構成ウィザードによって自動的に更新されない可能性があり、手動での更新が必要な場合があります。手動で更新する必要があるファイルは、以前に実行したカスタマイズのレベルによって異なります。

Oracle Fusion Middleware Infrastructure、Oracle FormsおよびOracle Reportsソフトウェアを入手するには、「Oracle Fusion Middlewareソフトウェアの入手」を参照してください。

この項は次の項目で構成されています。

インプレース・アップグレードの実行

インプレース・アップグレードを実行するには、既存のOracleホーム・ディレクトリをバックアップし、必要なソフトウェアの最新バージョンを既存のディレクトリにインストールしてから、バックアップ・ディレクトリから必要なファイルをコピーします。

インプレース・アプローチは、既存のOracleホーム・パスを保持し、アップグレード後の手動ステップの量を最小限に抑えることができるため、推奨されるアップグレード方法です。

インプレース・アップグレードを実行するには、最初に既存のOracleホーム・ディレクトリの名前をOracle_Home_OLDのように変更してバックアップします。次に、Fusion Middleware Infrastructure 14.1.2.0.0およびOracle Forms and Reports 14.1.2.0.0を、以前に名前を変更する前にOracleホームを表していた同じディレクトリ・パスにインストールします。

ソフトウェアをインストールしたら、名前が変更されたディレクトリから新しいホームの同じディレクトリにカスタム・ファイルをコピーします。たとえば、\forms\java\のカスタム・ファイルをコピーすることが必要な場合があります。以前にOracleホームに配置されていた場合は、WLSドメイン(user_projects)も含めることができます。以前古いホームにあった場合は、新しいホームに移動する必要があります。ドメインが現在Oracleホームの外部のディレクトリにある場合は、そのドメインを移動またはコピーしないでください。

最後に、アップグレード・アシスタントおよび再構成ウィザードを使用して、ドメイン・リポジトリおよび構成をアップグレードします。

ノート:

Oracle提供のファイルは、古いバージョンから新しいホームにコピーしないでください。たとえば、Oracle提供のJARやバイナリ・ファイルはコピーしないでください。そうすると、新しいインストールが正しく機能しなくなります。

インプレース・アップグレードを実行するには:

  1. アップグレードするOracleホームに関連付けられているすべてのサーバーおよびプロセスを停止します。
  2. このノードでOracleホームの親ディレクトリの名前を変更します。たとえば、Oracle_Home_OLDです。
  3. ステップ2で名前を変更する前に、以前使用したものと同じOracleホーム・パスを使用してFusion Middleware Infrastructure 14.1.2.0.0をインストールします。
  4. ステップ3で使用したものと同じOracleホーム・パスを使用して、Oracle Forms and Reports 14.1.2.0.0をインストールします。
  5. WLSドメイン・ディレクトリ(user_projects)とそのサブディレクトリが古いOracleホームにある場合は、これらのディレクトリを以前と同じ場所にある新しいOracleホームにコピーします。
  6. ドメイン(user_projects)のバックアップ・コピーをまだ作成していない場合は、続行する前に今すぐ作成してください。

    警告:

    アップグレード・アシスタントまたは再構成ウィザード(あるいはその両方)が実行されると、変更は元に戻せません。
  7. アップグレード・アシスタントを実行して、ドメイン・スキーマをアップグレードします。
    1. Upgrade Assistantの起動:
      $ORACLE_HOME/oracle_common/upgrade/bin/ua
    2. 「ドメインで使用されるすべてのスキーマ」を選択します。
    3. アップグレードするドメインへのパスを入力します。
    4. 「前提条件」画面で、すべてのチェック・ボックスを選択して、記載されている前提条件を満たしていることを確認します。
    5. DBAユーザー名の入力を求められたら、DBA権限を持つユーザー(sys as sysdbaなど)を入力します。
    6. 「接続」「次」の順にクリックして続行します。
    7. 「WLSスキーマ」画面が表示されるまで、「次」をクリックし続けます。
    8. スキーマ・ユーザー名が<YOUR PREFIX>_WLS_RUNTIMEの場合は、<YOUR PREFIX>_WLSに変更してから続行します。
  8. 再構成ウィザードを実行します。
    1. 再構成ウィザードを起動します。
      $ORACLE_HOME/oracle_common/common/bin/reconfig.sh
    2. 再構成(アップグレード)するドメインへのパスを入力します。
    3. 「データベース構成タイプ」画面が表示されるまで、「次」をクリックします。
    4. 「RCU構成の取得」をクリックして、関連付けられたスキーマから詳細をロードしてから続行します。
    5. 「拡張構成」画面で、「管理サーバーおよびトポロジ」を選択します。
    6. 「管理サーバー」画面で、「リスニング・アドレス」の値が設定されていることを確認します。値が設定されていない場合は、リストから「すべてのローカル・アドレス」を選択し、「次」をクリックして続行します。
    7. 「構成のサマリー」画面が表示されるまで続行し、「再構成」をクリックします。
  9. アップグレード・アシスタントを再度実行して、ドメインの再構成およびアップグレードを完了します。
    1. Upgrade Assistantの起動:
      $ORACLE_HOME/oracle_common/upgrade/bin/ua
    2. 「ドメインによって使用されるすべての構成」を選択します。
    3. アップグレードするドメインへのパスを入力します。
    4. 「前提条件」画面で、すべてのチェック・ボックスを選択して、記載されている前提条件を満たしていることを確認します。
    5. 調査フェーズが完了したら、「次」「アップグレード」の順にクリックして処理を開始します。
  10. ノード・マネージャ、管理サーバー、管理対象サーバーおよびその他のシステム・コンポーネント(OHSなど)を起動します。

    ノート:

    アップグレード後に初めてサーバーを起動する場合、通常よりも時間がかかることがあります。これは想定どおりです。

マルチノード環境でアップグレードする場合は、ステップ7を除き、追加ノードごとにこれらのステップをすべて繰り返します。追加ノードごとにドメイン・スキーマをアップグレードする必要はありません。

インストールを完了してサーバーを起動した後、Oracle_Home_OLDディレクトリを削除できます。ただし、削除する前に、必要なカスタム・ファイルをOracle_Home_OLDディレクトリからコピーしたことを確認してください。新しいインストールをテストして正しく機能していることを確認するまで、以前のOracleホームを削除しないことをお薦めします。

これらのステップを完了した後、「アップグレードの完了」に進みます。

アウトオブプレース・アップグレードの実行

アウトオブプレース・アップグレードを実行するには、フレッシュ・インストールとしてソフトウェアをインストールしてから、WLS再構成ウィザードおよびアップグレード・アシスタントを使用してアップグレードを完了します。

アウトオブプレース・アップグレードでは、Oracleホーム・ディレクトリの場所を以前の場所から変更できます。ただし、ドメイン(user_projects)が古いホーム内に存在する場合は、このディレクトリ構造を無期限に保持する必要があります。

ノート:

このアップグレード方法では、アップグレード・ツールでは更新できない一部の構成ファイルを手動で編集することが必要な場合があります。更新する必要があるファイルは、以前に更新したファイルによって異なります。

アウトオブプレース・アップグレードを実行するには、Fusion Middleware Infrastructure 14.1.2.0.0およびOracle Forms and Reports 14.1.2.0.0を、同じでも新しい空のディレクトリ・パスにインストールします。次に、必要なカスタム・ファイルを古いホームから新しいディレクトリにコピーします。これには、以前のホームで持っていたカスタム・ファイル( \forms\javaのカスタム・ファイルなど)が含まれる場合があります。これを実行したら、アップグレード・アシスタントおよび再構成ウィザードを使用して、ドメイン・リポジトリおよび構成をアップグレードします。

ノート:

Oracle提供のファイルは、古いホームから新しいホームにコピーしないでください。たとえば、Oracle提供のJARファイルまたはバイナリ・ファイルはコピーしないでください。そうすると、新しいインストールが正しく機能しなくなります。

アウトオブプレース・アップグレードを実行するには:

  1. アップグレードするOracleホームに関連付けられているすべてのサーバーおよびプロセスを停止します。
  2. このノードの新しい空のディレクトリにFusion Middleware Infrastructure 14.1.2.0.0をインストールします。
  3. ステップ2で使用したものと同じOracleホーム・パスにOracle Forms and Reports 14.1.2.0.0をインストールします。
  4. ドメイン(user_projects)のバックアップ・コピーをまだ作成していない場合は、続行する前に今すぐ作成してください。

    警告:

    アップグレード・アシスタントまたは再構成ウィザード(あるいはその両方)が実行されると、変更は元に戻せません。
  5. アップグレード・アシスタントを実行して、ドメイン・スキーマをアップグレードします。
    1. Upgrade Assistantの起動:
      $ORACLE_HOME/oracle_common/upgrade/bin/ua
    2. 「ドメインで使用されるすべてのスキーマ」を選択します。
    3. アップグレードするドメインへのパスを入力します。
    4. 「前提条件」画面で、すべてのチェック・ボックスを選択して、記載されている前提条件を満たしていることを確認します。
    5. DBAユーザー名の入力を求められたら、DBA権限を持つユーザー(sys as sysdbaなど)を入力します。
    6. 「接続」「次」の順にクリックして続行します。
    7. 「WLSスキーマ」画面が表示されるまで、「次」をクリックし続けます。
    8. スキーマ・ユーザー名が<YOUR PREFIX>_WLS_RUNTIMEの場合は、<YOUR PREFIX>_WLSに変更してから続行します。
  6. 再構成ウィザードを実行します。
    1. 再構成ウィザードを起動します。
      $ORACLE_HOME/oracle_common/common/bin/reconfig.sh
    2. 再構成(アップグレード)するドメインへのパスを入力します。
    3. 「データベース構成タイプ」画面が表示されるまで、「次」をクリックします。
    4. 「RCU構成の取得」をクリックして、関連付けられたスキーマから詳細をロードしてから続行します。
    5. 「拡張構成」画面で、「管理サーバーおよびトポロジ」を選択します。
    6. 「管理サーバー」画面で、「リスニング・アドレス」の値が設定されていることを確認します。値が設定されていない場合は、リストから「すべてのローカル・アドレス」を選択し、「次」をクリックして続行します。
    7. 「構成のサマリー」画面が表示されるまで続行し、「再構成」をクリックします。
  7. アップグレード・アシスタントを再度実行して、ドメインの再構成およびアップグレードを完了します。
    1. Upgrade Assistantの起動:
      $ORACLE_HOME/oracle_common/upgrade/bin/ua
    2. 「ドメインによって使用されるすべての構成」を選択します。
    3. アップグレードするドメインへのパスを入力します。
    4. 「前提条件」画面で、すべてのチェック・ボックスを選択して、記載されている前提条件を満たしていることを確認します。
    5. 調査フェーズが完了したら、「次」「アップグレード」の順にクリックして処理を開始します。
  8. ノードで、ノード・マネージャ、管理サーバー、管理対象サーバーおよびその他のシステム・コンポーネント(OHSなど)を起動します。

    ノート:

    アップグレード後に初めてサーバーを起動する場合、通常よりも時間がかかることがあります。これは想定どおりです。

マルチノード環境でアップグレードする場合は、ステップ5を除き、追加ノードごとにこれらのステップをすべて繰り返します。追加ノードごとにドメイン・スキーマをアップグレードする必要はありません。

ドメイン(user_projects)が古いホームに存在する場合は、このディレクトリ構造を保持し、アクセス可能なままにする必要があります。ただし、ドメインが以前のホーム内に存在しておらず、新しいインストールがテストされて正常に動作していることが確認されている場合は、古いホーム・インストールをアンインストールしてから削除できます。ドメイン(user_projects)ディレクトリを削除しないでください。

これらのステップを完了した後、「アップグレードの完了」に進みます。

アップグレードの完了

Oracle Formsを14.1.2.0.0にアップグレードした後は、構成に応じてこれらの追加ステップを実行する必要がある場合があります。

Forms Application Services (FADS)構成

Forms Application Services (FADS)が環境で構成されていた場合は、アップグレード・オプションを指定してFADS構成スクリプト(fads_config.py)を実行する必要があります。

  1. 次のコマンドを実行します。

    ORACLE_HOME/oracle_common/common/bin/wlst.sh fads_config.py upgrade

  2. プロンプトに従います。

useridの暗号化

前のインストールが12.2.1.3から12.2.1.4または12.2.1.19にアップグレードされた場合は、useridパラメータの暗号化を手動で有効にし、Formsアプリケーション・キーストアへのアクセス権を付与する必要があります。

ノート:

12.2.1.4または12.2.1.19からアップグレードする場合、これらのステップは必要ありません。

useridパラメータの暗号化を有効にするには:

  1. (アウトオブプレース・アップグレードのみ)管理サーバーおよびForms管理対象サーバーで、forms.userid.encryption.enabledサーバー・パラメータをtrueに設定します。

    『Oracle WebLogic Serverサーバーの起動と停止の管理』ドメイン全体のサーバー・パラメータのカスタマイズに関する項を参照してください。

    次に、forms.userid.encryption.enabledパラメータが有効になっているsetUserOverridesLate.shファイル(Windowsの場合はsetUserOverridesLate.cmdを使用)のサンプルを示します。

    echo ""
    echo "*****************************************************"
    echo "** Executing setUserOverridesLate.sh"
    echo "*****************************************************"
     
    # specify additional java command line options for all servers
    
    EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES} -Dforms.userid.encryption.enabled=true"
    export EXTRA_JAVA_PROPERTIES
    
    echo "USER_MEM_ARGS=\"${USER_MEM_ARGS}\""
    echo "EXTRA_JAVA_PROPERTIES=\"${EXTRA_JAVA_PROPERTIES}\""
    echo ""
    echo "*****************************************************"
    echo "** End of setUserOverrideLate.sh"
    echo "*****************************************************"
    echo ""
    
  2. WLST (オンライン・モード)を使用して次のコマンドを実行し、FormsアプリケーションのキーストアにアクセスするためのFormsアプリケーションまたはMBeanへの権限を付与します。
    connect("<ADMIN SERVER USERNAME>","<PASSWORD>","localhost:7001")
    
    grantPermission(codeBaseURL="file:${common.components.home}/../forms/provision/forms-config-mbeans.jar",
    permClass="oracle.security.jps.service.keystore.KeyStoreAccessPermission",permTarget="stripeName=formsapp,
    keystoreName=formsks,alias=*", permActions="*") 
    
    grantPermission(codeBaseURL="file:${domain.home}/servers/${weblogic.Name}/tmp/_WL_user/formsapp_14.1.2/-",
    permClass="oracle.security.jps.service.keystore.KeyStoreAccessPermission", permTarget="stripeName=formsapp,
    keystoreName=formsks,alias=*",permActions="*")
    
  3. ノード・マネージャ、管理サーバーおよびForms管理対象サーバーを再起動します。