## Overview This is the procedure for upgrading Pleasanter version 1.4.8.0 or later that is running on Windows. ## Notes 1. Do not overwrite the currently running parameter file to the latest version. Parameters newly added in the latest version may be lost, and Pleasanter may not start. 1. If you have upgraded to Enterprise Edition and performed column expansion, please upgrade according to the "Procedure for upgrading Pleasanter upgraded to Enterprise Edition" in "Content provided for support contract holders". 1. Do not set the /l or /z parameters when running CodeDefiner. ## Limitations 1. The merge function of CodeDefiner is available from 1.4.8.0 onwards. 1. The merge function of CodeDefiner applies parameters added and deleted in the new version. 1. The version to be upgraded must be 1.4.0.0 or later. ## Procedure The procedure for upgrading is as follows. 1. Stop Pleasanter 1. Back up the database 1. Back up Pleasanter 1. Prepare Pleasanter 1. Prepare the application 1. Download the patch file 1. Reconfigure parameters 1. Run CodeDefiner 1. Check that Pleasanter is running ## 1. Stop Pleasanter 1. Open the "Tools (T)" menu in "Server Manager" and launch "Internet Information Services (IIS) Manager". 1. Select "Server name" from the left pane. Click "Stop" in the right pane to stop IIS.  ## 2. Back Up The Database Back up the database. **If you have upgraded to Enterprise Edition and expanded the columns, be sure to back it up** [Pleasanter User Manual - FAQ: Backup, Restore](https://pleasanter.org/manual?category=5580) ## 3. Back Up Pleasanter Rename the existing **C:\web\pleasanter\** to **C:\web\pleasanter_bk\** and back it up. ## 4. Prepare The Pleasanter ### 1. Prepare the application 1. Download the latest version of Pleasanter from the [GitHub release notes](https://github.com/Implem/Implem.Pleasanter/releases). 1. Unzip the downloaded zip file and extract it under C:\web\ on your local PC. Please make sure that the configuration under the **C:\web\** directory is as follows. C:\web\pleasanter C:\web\pleasanter_bk ### 2. Download the patch file 1. Download the same version of ParametersPatch.zip as the version you placed from [GitHub release notes](https://github.com/Implem/Implem.Pleasanter/releases). 1. Place ParametersPatch.zip under the **C:\web\pleasanter\** directory. C:\web\pleasanter\ParametersPatch.zip *Please place ParametersPatch.zip without unzipping it. ### 3. Reconfigure parameters Go to the C:\web\pleasanter\Implem.CodeDefiner\ folder and run the parameter merging process in CodeDefiner. ``` > cd C:\web\pleasanter\Implem.CodeDefiner > dotnet Implem.CodeDefiner.dll merge /b C:\web\pleasanter_bk /i C:\web\pleasanter ``` *The parameter file set by the extension under C:\web\pleasanter_bk\Implem.Pleasanter\App_Data\Parameters\ will also be applied to the new resource. **If you want to reset the parameters manually Please refer to [FAQ: How to reset parameters manually](https://pleasanter.org/ja/manual/faq-merge-parameters)** ## 5. Run CodeDefiner Start the command prompt or PowerShell, navigate to the Implem.CodeDefiner folder, and run CodeDefiner. Argument settings /l and /z are not required. ``` > cd C:\web\pleasanter\Implem.CodeDefiner > dotnet Implem.CodeDefiner.dll _rds ``` You will be asked to confirm the execution, so enter "y" and press Enter to execute. If you want to cancel the execution, enter "n" and press Enter.  *The Licensee display may be garbled depending on the environment. ## 6. Check That Pleasanter Is Running 1. Open the "Tools (T)" menu in "Server Manager" and start "Internet Information Services (IIS) Manager". 1. Select "Server name" from the left pane. Click "Start" on the right pane to start IIS.  1. After starting, select "「Site」" - "Default Web Site" from the left pane, click "*.80 (http) Reference" on the right pane, and start Pleasanter.  1. After logging in, click "Help" - "Version" in the navigation menu and confirm that the version is correct.  * If you do not need the C:\web\pleasanter_bk backed up in step 3, delete it. If you want to keep it, move it to a different folder. ## Supported Versions |Supported versions|Body| |:--|:--| |1.4.8.0 and later|Added parameter merging procedure| ## Related Information [FAQ: CodeDefiner stops working when automating setup](faq-codedefiner-stop) [List of CodeDefiner Commands](codedefiner-command)