## 概要 Azure App Serviceで運用しているプリザンターver1.4.8.0以降のバージョンアップ手順です。 ## 注意事項 1. 現在運用中のパラメータファイルを最新バージョンに上書きコピーしないでください。最新バージョンで新たに追加したパラメータが失われ、プリザンターが起動しない恐れがあります。 1. Enterprise Editionにアップグレードし項目拡張を実施している場合は、「サポート契約者様向け提供コンテンツ」の「EnterpriseEditionアップグレード済みプリザンターのバージョンアップ手順」に従ってバージョンアップを実施してください。 1.CodeDefiner実行時に/l、/zのパラメータを設定しないでください。 ## 制限事項 1. CodeDefinerのマージ機能は1.4.8.0以降より利用可能です。 1. CodeDefinerのマージ機能は、新バージョンで追加および削除されたパラメータを適用します。 1. バージョンアップ元は1.4.0.0以降が対象です。 ## 手順 バージョンアップ手順は以下の通りです。 1. プリザンターの停止 1. データベースのバックアップ 1. プリザンターのバックアップ 1. プリザンターの準備 1. アプリケーションの準備 1. パッチファイルのダウンロード 1. パラメータ再設定 1. アプリケーションの配置 1. CodeDefinerの実行 1. プリザンターの起動確認 ## 1. プリザンターの停止 1. [Azure Portal](https://portal.azure.com/)に接続します。 2. App Service を開きます。  3. 作成済みの App Service インスタンスを選択します。 4. App Serviceを停止します。 ## 2. データベースのバックアップ データベースをバックアップします。**Enterprise Editionにアップグレードし、項目を拡張している場合は必ずバックアップしてください** [Pleasanter ユーザーマニュアル － FAQ：バックアップ、リストア](https://pleasanter.org/manual?category=5580) ## 3. プリザンターのバックアップ 1. C:\web\pleasanter_bkフォルダをローカル環境に作成します。 2. [Kudu](https://docs.microsoft.com/ja-jp/azure/app-service/resources-kudu#access-kudu-for-your-app) にアクセスします。 1. App Service の左側のメニューの"開発ツール"から「高度なツール」をクリック  2. [移動](/ja/manual/table-record-move)のリンクをクリック  3. Kudu のヘッダメニューから「Debug console」>「CMD」をクリック  4. ディレクトリ一覧から「site」をクリックします。選択後、プロンプトが C:\home\site\となることを確認します。  3. Kudu上のC:\home\site\wwwroot\をダウンロードして、手順3.1でローカル環境に作成したフォルダ配下に配置し解凍します。 4. **C:\web\pleasanter_bk\wwwroot**を**C:\web\pleasanter_bk\Implem.Pleasanter**にリネームします。 　　変更前）c:\web\pleasanter\wwwroot 　　変更後）c:\web\pleasanter\Implem.Pleasanter ## 4. プリザンターの準備 ### 1. アプリケーションの準備 1. [ダウンロードセンター](https://pleasanter.org/dlcenter)から、プリザンター最新バージョンをダウンロードします。 1. ダウンロードしたzipファイルを解凍しローカル環境のC:\web\配下に解凍します。 **C:\web\** ディレクトリ配下の構成が以下のようになっていることを確認してください。 C:\web\pleasanter C:\web\pleasanter_bk ### 2. パッチファイルのダウンロード 1. [GitHubのリリースノート](https://github.com/Implem/Implem.Pleasanter/releases)から、配置したバージョンと同様のバージョンのParametersPatch.zipをダウンロードします。 1. ParametersPatch.zipを **C:\web\pleasanter\** ディレクトリ配下に配置します。 C:\web\pleasanter\ParametersPatch.zip ※ParametersPatch.zipは解凍せずに配置してください。 ### 3. パラメータ再設定 C:\web\pleasanter\Implem.CodeDefiner\フォルダに移動し、CodeDefinerでパラメータのマージ処理を実行します。 ``` > cd C:\web\pleasanter\Implem.CodeDefiner > dotnet Implem.CodeDefiner.dll merge /b C:\web\pleasanter_bk /i C:\web\pleasanter ``` ※C:\web\pleasanter_bk\Implem.Pleasanter\App_Data\Parameters\配下にある拡張機能で設定したパラメータファイルも新資源に適用されます。 **パラメータを手動で再設定する場合 [FAQ:パラメータを手動で再設定する手順を知りたい](https://pleasanter.org/ja/manual/faq-merge-parameters) を参照ください** ### 4. アプリケーションの配置 1. 手順4.3でパラメータ再設定したローカル環境の最新バージョンモジュールの「C:\web\pleasanter」フォルダに移動します。 2. 「C:\web\pleasanter\Implem.Pleasanter」フォルダを「wwwroot」にリネームします。 　　変更前）c:\web\pleasanter\Implem.Pleasanter 　　変更後）c:\web\pleasanter\wwwroot 3. wwwroot フォルダを zip 形式で圧縮し「wwwroot.zip」とします。 4. 「C:\web\pleasanter\Implem.CodeDefiner」フォルダを「 CodeDefiner 」にリネームします。 　　変更前）c:\web\pleasanter\Implem.CodeDefiner 　　変更後）c:\web\pleasanter\CodeDefiner 5. CodeDefiner フォルダを zip 形式で圧縮し「CodeDefiner.zip」とします。 6. wwwroot.zip と CodeDefiner.zip を Kudu の Size をターゲットにドラッグアンドドロップし、展開されて格納されたことを確認します。  ※念の為、既存の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 ``` 実行確認を求められますので、「y」を入力し、Enterキーを押して実行してください。実行をキャンセルしたい場合は「n」を入力し、Enterキーを押してください。  ※Licenseeの表示は環境によって文字化けする可能性があります。 ## 6. プリザンターの起動確認 1. App Serviceを開き、インスタンスを起動します。 1. ブラウザでプリザンターのログイン画面を開き、ログイン後、ナビゲーションメニューの「ヘルプ」－「バージョン」をクリックし、バージョンが正しいことを確認します。  ※手順3でバックアップしたC:\web\pleasanter_bkは不要な場合は削除してください。保存しておく場合は別フォルダに退避してください。 ## 対応バージョン |対応バージョン|内容| |:--|:--| |1.4.8.0 以降|パラメータのマージ手順追加| ## 関連情報 [FAQ：セットアップを自動化した際にCodeDefinerの処理が止まってしまう](faq-codedefiner-stop) [CodeDefinerのコマンド一覧](codedefiner-command)