Spatial Studioのアップグレード

2.3 Spatial Studioのアップグレード

この項では、既存のOracle Spatial Studioデプロイメントを24.2.0にアップグレードするプロセスについて説明します。

ノート:

22.3.0より前のSpatial Studioバージョンを実行している場合は、最初にSpatial Studio 22.3.0をダウンロードして正常にログインする必要があります(「Oracle Software Delivery CloudからのSpatial Studio 22.3.0のダウンロード」を参照)。これは、23.1.0のメタデータ・スキーマに新しいバージョン管理メカニズムが導入されており、Spatial Studioでは既存のメタデータ・スキーマがすでにSpatial Studio 22.3.0のバージョンにあると想定されているためです。そのため、最新のバージョンをダウンロードして実行する前に、少なくとも1回は22.3.0 Webアプリケーションにログインする必要があります。そうしないと、Spatial Studioバージョン24.2.0は、次のSEVEREエラー・メッセージをログに記録して起動プロセスを中止します。

!!! Spatial Studio ver. 22.3.0 must be run at least once against your repository schema before upgrading to this version !!!

ヒント:

現在のSpatial Studioインストールのバージョンを確認するには、Webアプリケーションにログインして、アバターのドロップダウン・メニューから「情報」メニュー項目をクリックします。バージョン番号が表示されます。

すでにSpatial Studio 22.3.0以降を使用している場合は、次の各項で、既存のホストでのSpatial Studioのアップグレード(インプレース・アップグレード)または新しいホストへのデプロイ(アウトオブプレース・アップグレード)時のステップについて説明します。

Spatial Studioのアップグレードの前提条件タスク
インプレース・アップグレード
アウトオブプレース・アップグレード
Oracle Software Delivery CloudからのSpatial Studio 22.3.0のダウンロード
Spatial Studio 22.3.0は、Oracle Software Delivery Cloudからダウンロードできます。

親トピック: Oracle Spatial Studioの管理

2.3.1 Spatial Studioのアップグレードの前提条件タスク

Spatial Studioのアップグレードを準備するには、次の前提条件ステップを実行します:

実行中のすべてのSpatial Studioインスタンスを停止します。
次のアーティファクトのバックアップを取得します:
- 次のようなリポジトリ・メタデータ・スキーマ表:
  - SGTECH_META_VERSION
  - SGTECH_OBJECT
  - SGTECH_SYS_TYPE
  - SGTECH_TASK_BROKER
  - SGTECH_TASK_QUEUE
  データ・ポンプ・ユーティリティを使用して、前述のファイルをダンプ・ファイルにエクスポートできます。たとえば、メタデータ・スキーマ名がstudio_metadataでデータベース・サービス名orclpdbであると仮定した場合のデータ・ポンプ・エクスポート・コマンドを次に示します:
```
expdp studio_metadata/<password>@orclpdb directory=dumpdir
      dumpfile=spatial_studio_metadata_backup.dmp
      tables=SGTECH_META_VERSION,SGTECH_OBJECT,SGTECH_SYS_TYPE,SGTECH_TASK_BROKER,SGTECH_TASK_QUEUE
```
- 作業ディレクトリ(通常は~/.sgtech)
- 通常は作業ディレクトリにある、sgtech_config.json構成ファイル
- クイック・スタートの場合は、Spatial Studioユーザー(ユーザー名、暗号化された資格証明およびロール)を定義している<spatial_studio_home_dir>/conf/jetty-realm.propertiesファイルをバックアップします。
Spatial Studio 24.2.0バージョンをダウンロードして、アップグレードするホストにアップロードします。

親トピック: Spatial Studioのアップグレード

2.3.2 インプレース・アップグレード

Spatial Studioのインプレース・アップグレードの場合は、次のステップを実行します:

Spatial Studio 24.2.0アプリケーションを再デプロイします。
- クイック・スタートの場合: 古いクイック・スタート・フォルダの名前を変更します。新しくダウンロードしたZIPファイルを展開し、<spatial_studio_home_dir>/conf/jetty-realm.propertiesをバックアップ・コピーに置き換え、start.sh (Linux)またはstart.cmd (Windows)を実行します。
- EARデプロイメントの場合: アプリケーション・サーバーの手順に従って、古いデプロイメント・バージョンを削除します。次に、新しいバージョンをデプロイし、アプリケーションを起動します。

親トピック: Spatial Studioのアップグレード

2.3.3 アウトオブプレース・アップグレード

Spatial Studioのアウトオブプレース・アップグレードの場合は、次のステップを実行します:

新しいホストに作業ディレクトリを作成します。
```
mkdir ~/.sgtech
```
sgtech_config.json構成ファイルを古いホストの作業ディレクトリから新しいホストにコピーします。
```
cp old/sgtech_config.json ~/.sgtech
```
構成ファイル内のmaster_seedエントリが失われると、すべての接続パスワードが破損します。これが発生した場合は、アップグレードを続行し、アップグレード済のSpatial Studioインスタンスにログインして、各接続を編集し、パスワードを再入力してから再接続します。
Spatial Studioアプリケーションをデプロイします。
- クイック・スタートの場合: 新しくダウンロードしたZIPファイルを展開し、<spatial_studio_home_dir>/conf/jetty-realm.propertiesをバックアップ・コピーに置き換え、start.sh (Linux)またはstart.cmd (Windows)を実行します。
- EARデプロイメントの場合: アプリケーション・サーバーの手順に従って、新しいバージョンをデプロイし、アプリケーションを起動します。
アプリケーションの起動時に、リポジトリ・データベース・スキーマが自動的にアップグレードされます。

親トピック: Spatial Studioのアップグレード

2.3.4 Oracle Software Delivery CloudからのSpatial Studio 22.3.0のダウンロード

Spatial Studio 22.3.0は、Oracle Software Delivery Cloudからダウンロードできます。

https://edelivery.oracle.com/にログインします。
検索バーで「Oracle Spatial Studio」を検索します。
「Oracle Spatial Studio 22.3.0.0.0」をクリックします。
そのソフトウェアがカートに追加されます。
ページの右上にある続行をクリックします。
ページの右上にある続行をもう一度クリックします。
ライセンス契約を確認し、オラクル・ライセンス契約を確認した上でこれに同意しますチェック・ボックスを選択し、続行をクリックします。
「Spatial_Studio_qs_22.3.0.zip」の横にある「V1032893-01.zip」リンクをクリックします。
ご使用のシステムにそのソフトウェアがダウンロードされます。

親トピック: Spatial Studioのアップグレード