ここでは、デスクトップ環境がインストールされていないサーバーでアップデートする手順について説明します。Windowsや、Linuxでもデスクトップ環境がインストールされているサーバーでインストールする手順については、こちらのアップデート手順を参考にしてください。
Yellowfinのアップデートを行う前には事前に以下の作業を実施してください。
- Yellowfinのリポジトリデータベースのバックアップを取得
取得方法は各データベースによって異なります。 - Yellowfinモジュールのバックアップを取得
アップデートツール実行時、<Yellowfinインストールディレクトリ>/backup/yfpatch-YYYYMMDD（日付はアップデート実施日）にROOTディレクトリをバックアップしますが、必要に応じてディレクトリごとコピーを行ってください。 -
リポジトリ DBのタイムアウトの設定変更
v9へのアップデートは、アップデートキット実行後の初回起動時にコンテンツのコンバート処理が実行されます。
コンテンツが多い場合リポジトリDBへ大量の更新処理が実行されるため、起動に時間を要します。
コンテンツが多い場合コンバート処理中にリポジトリDBとのタイムアウトが発生し、コンバートが不完全な状態で中断され、アップデート後の動作に支障をきたす場合がございます。
対策としては、Yellowfinのアップデート実行前にリポジトリDBのタイムアウトを延ばしてください
（方法は記事参照：60分に延ばす）。 - Yellowfinの停止
アップデートは必ずYellowfinを停止した状態で行ってください。
【注意！】Ver9よりアップデート時に以下の2つの設定が追加されています。
こちらの設定は選択によっては既存コンテンツのフォントが変更されることもございます。
アップデート前には必ず「Yellowfin9変更管理ドキュメント」をご一読いただいてから、アップデートを行ってください。
- レポートおよびグラフの色、フォント、スタイルのデフォルト設定に関して
チェックボックスを選択した場合：
新しいデフォルト値が、すべての既存コンテンツおよび新規コンテンツに適用されます。
チェックボックスを選択しない場合：
以前のデフォルト値が、維持されます。すべての既存コンテンツおよび新規コンテンツは以前のデフォルト値が適用されます。 -
グラフビルダーで設定するグラフ書式のデフォルト設定に関して
チェックボックスを選択した場合：
新しいデフォルト値が、すべての既存コンテンツおよび新規コンテンツに適用されます。
チェックボックスを選択しない場合：
新しいデフォルト値が、新規コンテンツへ適用されます。すべての既存コンテンツは以前のデフォルト値が維持されます。
※. コンテキストパスを設定している場合
コンテキストパスを設定している場合、Yellowfinのアップデート手順が通常とは異なります。
コンテキストパスを設定している場合、アップデートキットでインストールディレクトリを指定する際に、コンテキストパスのディレクトリを指定するようにしてください。
詳細は下記リンク先の記事をご参照ください。
https://support.yellowfin.co.jp/hc/ja/articles/115012491488
以下、実行時のCUIイメージにそって、アップデート手順を説明します。
パスは、実際にインストール環境に合わせて読み替えてください。入力箇所には、⏎記号を添えています。
緑の文字は各ステップに対するコメントです。
|
java -jar yellowfin-9.1.0-20200330-update.jar⏎ This patch updates Yellowfin to version 9.1. Before continuing, please: Please select the directory where Yellowfin is installed. Enter the installation directory: /usr/local/Yellowfin⏎ Do you want to apply the new configuration level defaults? This is permanent and cannot be undone. (Y/N)? n⏎ Do you want to apply the new chart level defaults? This is permanent and cannot be undone. (Y/N)? n⏎ --- Patch parameters --- --- Yellowfin installation --- UpgradeType: ALL
Backing up database Compacting database Updating libraries <---------------------------------------- この後処理がアップデート処理が実行されるため一部割愛します ------------------------------------------> Writing updated web.xml Writing updated web.xml with the new JsAPI URL pattern Updating styles Copying files Copying files --- Yellowfin Patch Installation Complete --- |
アップデートが完了したら、アップデート後の動作確認をおこなってください。