Procedure for Migrating Pleasanter 1.4 to Pleasanter 1.5 Installed on Azure App Service
## Overview
This procedure is for upgrading Pleasanter using the "Installer". When using the installer, it automatically backs up existing applications, downloads the latest version resources, and merges parameters.
You can also upgrade using the previous procedure of manually backing up, arranging modules, and merging parameters. Please refer to the following for manual upgrade procedures.
[Upgrade Procedure for Version 1.4.8.0 or Later (Azure App Service)](version-up-azure-1.4.8.0)
[Pleasanter Version Upgrade Procedure (Azure App Service)](version-up-azure)
## Notes
1. When using the installer, Pleasanter will be upgraded to version 1.5. If you are using Pleasanter 1.4, please specify .NET 10 in the stack settings.
1. If you have upgraded to Enterprise Edition and performed column expansion, please upgrade according to the "Upgrade Procedure for Enterprise Edition Upgraded Pleasanter" in "Content provided for support contract holders".
1. If you are currently running a "trial" of Pleasanter Extensions, you cannot perform a version upgrade using this procedure. For details, please refer to "Precautions for Pleasanter Extensions Trial".
1. When using the installer update and merge functions in ver.1.4.17.0 or later, please review the [Precautions when using the merge function in ver.1.4.17.0](https://pleasanter.org/ja/manual/version-up-ver1.4.17.0-caution).
## Limitations
1. The version to be upgraded is 1.4.0.0 or later.
1. The version to be upgraded using the "Installer" is 1.4.0.0 or later. Please refer to the manual upgrade procedure when upgrading from ver1.3.50.2 or earlier.
[Pleasanter Version Upgrade Procedure (Azure App Service)](version-up-azure)
1. The version to be upgraded is 1.4.8.0 or later.
## Procedure
The procedure for upgrading is as follows.
1. Stop Pleasanter
1. Back up the database
1. Changing Stack Settings
1. Install the installer
1. Run the installer
1. Check that Pleasanter is running
## 1. Stop Pleasanter
1. Connect to [Azure Portal](https://portal.azure.com/).
2. Open App Service.
3. Select the created App Service instance.
4. Stop the App Service.
## 2. Back up the Database
Back up your database. **If you have upgraded to Enterprise Edition and expanded columns, be sure to back up your database**
[Pleasanter User Manual - FAQ: Backup, Restore](https://pleasanter.org/manual?category=5580)
## 3. Changing Stack Settings
1. Open App Service.
1. Select the created App Service instance.
1. Select "Settings" - "Configuration (Preview)" and open the "Stack settings" tab. Select ".NET" for "Stack" and select ".NET 10 (LTS)" for ".NET version".
## 4. Install the Installer
### 1. Access [Kudu](https://learn.microsoft.com/en-us/azure/app-service/resources-kudu#access-kudu-for-your-app).
1. Click "Advanced Tools" from "Developer Tools" in the left menu of App Service
2. Click the "「Move」" link
3. Click "Debug console" > "CMD" from the Kudu header menu
4. Install the installer. (Depending on the user, it may be D:\home. In that case, please read appropriately.)
**Please be sure to run it even if it is already installed. If the installer has been updated, install it as an update.**
1. Open the Nuget Gallery for Implem.PleasanterSetup from [here](https://www.nuget.org/packages/Implem.PleasanterSetup/) and download the .nupkg file from "Download package".
2. Execute the following command to create a folder of your choice to install the installer.
*This procedure explains how to create C:\home\dotnet-tools.
```
mkdir C:\home\dotnet-tools
```
3. Place the .nupkg file downloaded in 2.4.1 in C:\home\dotnet-tools.
4. Run the following command to install the installer.
```
dotnet tool install Implem.PleasanterSetup --tool-path C:\home\dotnet-tools --add-source C:\home\dotnet-tools
set PATH=%PATH%;C:\home\dotnet-tools
```
## 5. Run the Installer
1. Run the installer by executing the following command.
```
pleasanter-setup
```
2. Enter the directory where you want to install Pleasanter.
If you want to install it to "C:\home\site\wwwroot", leave it blank and press Enter.
3. Enter the directory where you want to install CodeDefiner.
If you want to install it to "C:\home\site\CodeDefiner", leave it blank and press Enter.
4. A summary screen will be displayed.
Check the contents and enter **y** after "Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)'. : " and press Enter.
※The password is masked.
***After entering "y", it may take some time for the operation to start. Please wait without changing the directory.**
5. When "Type "y" (yes) if the license is correct, otherwise type "n" (no)" is displayed, enter **y** and execute.
```
<SUCCESS> Starter.ConfigureDatabase: Database configuration has been completed.
<SUCCESS> Starter.Main: All of the processes have been completed.
Setup is complete.
```
6. When setup is complete, a web browser will launch and display the [Enterprise Edition trial information page](https://pleasanter.org/pleasanter-extensions-trial/?utm_source=installer&utm_medium=app&utm_campaign=extension-trial&utm_content=route01&_gl=1*1yskiwt*_ga*MTM3OTgwMzk2My4xNzYwNjg2Mzc2*_ga_FHETHGLQJE*czE3Njc1NzA3OTkkbzEyMiRnMSR0MTc2NzYwMjMxMyRqNDUkbDAkaDA.).
## 6. Check that Pleasanter is running
1. Open App Service and start the instance.
1. Open the Pleasanter login screen in your browser, and after logging in, click "Help" - "Version" in the navigation menu to confirm that the version is correct.
* If you do not need the C:\home\site\wwwroot_yyyyMMdd_HHmmss and C:\home\site\CodeDefiner_yyyyMMdd_HHmmss backed up by the installer, delete them. If you want to save them, move them to a different folder.
