プリザンターのバージョンアップ手順(Windows)
## 概要
Windowsで運用しているプリザンターのバージョンアップ手順です。
## 注意事項
1. 現在運用中のパラメータファイルを最新バージョンに上書きコピーしないでください。最新バージョンで新たに追加したパラメータが失われ、プリザンターが起動しない恐れがあります。
1. Enterprise Editionを使用し項目拡張を実施している場合は、「サポート契約者様向け提供コンテンツ」の「EnterpriseEditionアップグレード済みプリザンターのバージョンアップ手順」に従ってバージョンアップを実施してください。
1.CodeDefiner実行時に/l、/zのパラメータを設定しないでください。
## 前提条件
1. プリザンター 1.3 以前のバージョンから、プリザンター 1.4 以降へバージョンアップする場合、[.NET8のインストール](https://pleasanter.org/manual/install-dotnet)が必要です。
## 手順
バージョンアップ手順は以下の通りです。
1. データベースのバックアップ
1. パラメータファイルのバックアップ
1. プリザンターの準備
1. アプリケーションの準備
1. パラメータ再設定
1. 拡張機能の再設定
1. プリザンターの配置
1. プリザンターの停止
1. アプリケーションの配置
1. CodeDefinerの実行
1. プリザンターの起動確認
## 1. データベースのバックアップ
データベースをバックアップします。**Enterprise Editionにアップグレードし、項目を拡張している場合は必ずバックアップしてください**
[Pleasanter ユーザーマニュアル - FAQ:バックアップ、リストア](https://pleasanter.org/manual?category=5580)
## 2. パラメータファイルのバックアップ
1. パラメータファイルをバックアップします。このバックアップは手順3.2.で使用します。パラメータファイルはマニュアル通りにセットアップした場合、C:\web\pleasanter\Implem.Pleasanter\App_Data\Parameters\配下のjsonファイルとなります。
1. **拡張機能を利用していない場合は本手順は不要です。** 拡張機能で設定したパラメータファイルをバックアップします。このバックアップは手順3.3.で使用します。拡張機能で設定したファイルはマニュアル通りにセットアップした場合、C:\web\pleasanter\Implem.Pleasanter\App_Data\Parameters\配下にある以下サブフォルダ内のファイルとなります。
|サブフォルダ名|拡張機能名|備考|
|:---|:---|:---|
|CustomDefinitions|[拡張項目](/ja/manual/extended-column)|組織、グループ、ユーザに項目を追加した際に生成されるフォルダ|
|ExtendedFields|[拡張フィールド](/ja/manual/extended-fields)||
|ExtendedHtmls|[拡張HTML](/ja/manual/table-management-extended-html)||
|ExtendedNavigationMenus|[拡張ナビゲーションメニュー](/ja/manual/extended-navigationmenus)||
|ExtendedScripts|[拡張スクリプト](/ja/manual/extended-script)||
|ExtendedServerScripts|[拡張サーバスクリプト](/ja/manual/extended-server-script)||
|ExtendedSqls|[拡張SQL](/ja/manual/extended-sql)||
|ExtendedStyles|[拡張スタイル](/ja/manual/extended-style)||
## 3. プリザンターの準備
### 1. アプリケーションの準備
1. [ダウンロードセンター](https://pleasanter.org/dlcenter)から、プリザンター最新バージョンをダウンロードします。
1. ダウンロードしたzipファイルを解凍します。
### 2. パラメータ再設定
手順3.1で準備した最新バージョンモジュールのパラメータファイルに対して、現在設定済みの内容を反映します。[WinMerge](https://winmergejp.bitbucket.io/)などのファイル比較・マージツールを利用して最新バージョンモジュールのパラメータファイルと手順2.で取得したバックアップファイルのパラメータファイルを比較しながら最新バージョンモジュールのパラメータファイルを修正します。
**Service.jsonのTimezoneDefaultが正しい値か確認してください。TimezoneDefaultにはPleasanterをインストールするサーバのOSで有効なタイムゾーンを設定してください。(Windowsなら"Tokyo Standard Time"など、Linuxなら"Asia/Tokyo"など)**
[FAQ:プリザンターでサポートしている言語とタイムゾーンのパラメータの設定値を知りたい](https://pleasanter.org/ja/manual/faq-supported-language)
### 3. 拡張機能の再設定
**拡張機能を利用していない場合は本手順は不要です。** 手順3.1で準備した最新バージョンモジュールの拡張機能用パラメータファイルに対して、現在設定済みの内容を反映します。[WinMerge](https://winmergejp.bitbucket.io/)などのファイル比較・マージツールを利用して最新バージョンモジュールの拡張機能用パラメータファイルと手順2.で取得したバックアップファイルの拡張機能用パラメータファイルを比較しながら最新バージョンモジュールの拡張機能用パラメータファイルを修正します。
## 4. プリザンターの配置
### 1. プリザンターの停止
1. 「サーバマネージャー」の「ツール(T)」メニューを開き「インターネット インフォメーション サービス(IIS)マネージャー」を起動してください。
1. 左ペインより「サーバー名」を選択します。右ペインの「停止」をクリックして、IISを停止してください。
![image](https://pleasanter.org/binaries/033a9ee7aa0841369709641c7d94b2bb)
### 2. アプリケーションの配置
1. C:\web\内に解凍した新バージョンのプリザンターを配置します。
※念の為、既存のC:\web\pleasanter\をC:\web\pleasanter_bk\などとリネームしてバックアップしたうえで、新バージョンを配置することを推奨します。
## 5. CodeDefinerの実行
コマンドプロンプトまたはPowerShellを起動し、Implem.CodeDefinerフォルダーに移動しCodeDefinerを実行します。/l、/zの引数設定は不要です。
```
> cd C:\web\pleasanter\Implem.CodeDefiner
> dotnet Implem.CodeDefiner.dll _rds
```
## 6. プリザンターの起動確認
1. 「サーバマネージャー」の「ツール(T)」メニューを開き「インターネット インフォメーション サービス(IIS)マネージャー」を起動します。
1. 左ペインより「サーバー名」を選択します。右ペインの「開始」をクリックして、IISを開始します。
![image](https://pleasanter.org/binaries/1fb50733a47b423591b1490ba1c8a272)
1. 開始後、左ペインより[サイト](/ja/manual/site)-「Default Web Site」を選択し、右ペインの「*.80(http)参照」をクリックし、プリザンターを起動します。
![image](https://pleasanter.org/binaries/5be4e5794d5941d2b31a51f81a26e0a4)
1. ログイン後、ナビゲーションメニューの「ヘルプ」-「バージョン」をクリックし、バージョンが正しいことを確認します。
![image](https://pleasanter.org/binaries/0d80470fa83c40bd99c057d2447549e0)