コンテンツにスキップ
「プリザンター入門」発売中！

プリザンターのバージョンアップ手順(Azure App Service)

概要

Azure App Serviceで運用しているプリザンターのバージョンアップ手順です。

注意事項

  1. 現在運用中のパラメータファイルを最新バージョンに上書きコピーしないでください。最新バージョンで新たに追加したパラメータが失われ、プリザンターが起動しない恐れがあります。
  2. Enterprise Editionにアップグレードし項目拡張を実施している場合は、Enterprise Edition - バージョンアップ手順に従ってバージョンアップを実施してください。
  3. Pleasanter Extensionsのトライアルを実施中の場合は、「Pleasanter Extensionsのトライアルの注意点」を確認してください。
    1.CodeDefiner実行時に/l、/zのパラメータを設定しないでください。

前提条件

  1. プリザンター 1.3 以前のバージョンから、プリザンター 1.4 以降へバージョンアップする場合、.NET8のインストールが必要です。

手順

バージョンアップ手順は以下の通りです。
1. データベースのバックアップ
1. パラメータファイルのバックアップ
1. プリザンターの準備
1. アプリケーションの準備
1. パラメータ再設定
1. 拡張機能の再設定
1. プリザンターの配置
1. プリザンターの停止
1. アプリケーションの配置
1. CodeDefinerの実行
1. プリザンターの起動確認

1. データベースのバックアップ

データベースをバックアップします。Enterprise Editionにアップグレードし、項目を拡張している場合は必ずバックアップしてください
Pleasanter ユーザーマニュアル － FAQ：バックアップ、リストア

2. パラメータファイルのバックアップ

  1. パラメータファイルをバックアップします。このバックアップは手順3.2.で使用します。パラメータファイルはマニュアル通りにセットアップした場合、C:\home\sites\wwwroot\Implem.Pleasanter\App_Data\Parameters\配下のjsonファイルとなります。

  2. 拡張機能を利用していない場合は本手順は不要です。 拡張機能で設定したパラメータファイルをバックアップします。このバックアップは手順3.3.で使用します。拡張機能で設定したファイルはマニュアル通りにセットアップした場合、C:\home\sites\wwwroot\Implem.Pleasanter\App_Data\Parameters\配下にある以下サブフォルダ内のファイルとなります。

    サブフォルダ名 拡張機能名 備考
    CustomDefinitions 拡張項目 組織、グループ、ユーザに項目を追加した際に生成されるフォルダ
    ExtendedFields 拡張フィールド
    ExtendedHtmls 拡張HTML
    ExtendedNavigationMenus 拡張ナビゲーションメニュー
    ExtendedScripts 拡張スクリプト
    ExtendedServerScripts 拡張サーバスクリプト
    ExtendedSqls 拡張SQL
    ExtendedStyles 拡張スタイル

3. プリザンターの準備

1. アプリケーションの準備

  1. ダウンロードセンターから、プリザンター最新バージョンをダウンロードします。
  2. ダウンロードしたzipファイルを解凍します。

2. パラメータ再設定

手順3.1.で準備した最新バージョンモジュールのパラメータファイルに対して、現在設定済みの内容を反映します。WinMergeなどのファイル比較・マージツールを利用して最新バージョンモジュールのパラメータファイルと手順2.で取得したバックアップファイルのパラメータファイルを比較しながら最新バージョンモジュールのパラメータファイルを修正します。
Service.jsonのTimezoneDefaultが正しい値か確認してください。TimezoneDefaultにはPleasanterをインストールするサーバのOSで有効なタイムゾーンを設定してください。（Windowsなら"Tokyo Standard Time"など、Linuxなら"Asia/Tokyo"など）
FAQ：プリザンターでサポートしている言語とタイムゾーンのパラメータの設定値を知りたい

3. 拡張機能の再設定

拡張機能を利用していない場合は本手順は不要です。 手順3.1で準備した最新バージョンモジュールの拡張機能用パラメータファイルに対して、現在設定済みの内容を反映します。WinMergeなどのファイル比較・マージツールを利用して最新バージョンモジュールの拡張機能用パラメータファイルと手順2.で取得したバックアップファイルの拡張機能用パラメータファイルを比較しながら最新バージョンモジュールの拡張機能用パラメータファイルを修正します。

4. プリザンターの配置

1. プリザンターの停止

  1. Azure Portalに接続します。
  2. App Service を開きます。
    Azure Portalの画面。App Serviceを開くところ
  3. 作成済みの App Service インスタンスを選択します。
  4. App Serviceを停止します。

2. アプリケーションの配置

  1. Kudu にアクセスします。
  2. App Service の左側のメニューの"開発ツール"から「高度なツール」をクリック
    App Serviceの左メニュー。「開発ツール」の中に「高度なツール」がある
  3. 移動のリンクをクリック
    App Serviceの「高度なツール」画面。Kuduへの「移動」リンクがある
  4. Kudu のヘッダメニューから「Debug console」>「CMD」をクリック
    Kuduのヘッダメニュー。「Debug console」の中に「CMD」がある
  5. ディレクトリ一覧から「site」をクリックします。選択後、プロンプトが C:\home\site\となることを確認します。
    Kuduのディレクトリ一覧。「site」を選んだ状態
  6. 手順3.2.でパラメータ再設定した最新バージョンモジュールの「pleasanter」フォルダに移動します。
  7. 「Implem.Pleasanter」フォルダを「wwwroot」にリネームします。
  8. wwwroot フォルダを zip 形式で圧縮し「wwwroot.zip」とします。
  9. 「Implem.CodeDefiner」フォルダをCodeDefinerにリネームします。
  10. CodeDefiner フォルダを zip 形式で圧縮し「CodeDefiner.zip」とします。
  11. wwwroot.zip と CodeDefiner.zip を Kudu の Size をターゲットにドラッグアンドドロップし、展開されて格納されたことを確認します。
    Kuduにwwwroot.zipとCodeDefiner.zipを配置し、展開された状態
    ※念の為、既存のC:\home\site\wwwroot\およびC:\home\site\CodeDefiner\をそれぞれC:\home\site\wwwroot_bk\、C:\home\site\CodeDefiner_bk\などとリネームしてバックアップしたうえで、新バージョンを配置することを推奨します。

5. CodeDefinerの実行

  1. Kudu のディレクトリ一覧から CodeDefiner を選択し、プロンプトが C:\home\site\CodeDefiner となることを確認します。
  2. 以下のコマンドを実行して、CodeDefinerを実行します。/l、/zの引数設定は不要です。
dotnet Implem.CodeDefiner.dll _rds /p C:\home\site\wwwroot

6. プリザンターの起動確認

  1. App Serviceを開き、インスタンスを起動します。
  2. ブラウザでプリザンターのログイン画面を開き、ログイン後、ナビゲーションメニューの「ヘルプ」－「バージョン」をクリックし、バージョンが正しいことを確認します。
    「ヘルプ」－「バージョン」で表示したプリザンターのバージョン情報