Procedure for Migrating Pleasanter 1.4 to Pleasanter 1.5 Installed on Azure App Service

Overview¶

This procedure migrates Pleasanter 1.4 installed on Azure App Service to Pleasanter 1.5.

Preliminary Check¶

Check the version of Pleasanter installed on App Service.

1. Log in to Pleasanter.
2. Click "Help" in the navigation menu.
3. Click "Version".
4. Confirm that the version is "1.4.x.x".

Preparations¶

Back up the Database¶

Back up the database. If you have upgraded to Enterprise Edition and extended columns, be sure to back up the database.
Backup & Restore

1. Change the Stack Settings¶

1. Open App Service.
2. Select the App Service instance you created.
3. Select "Settings" - "Configuration (preview)" and open the "Stack settings" tab. Select .NET for "Stack", and select ".NET 10 (LTS)" for ".NET version".
   

2. Install or Update the Installer¶

Be sure to run this even if the installer is already installed. If a newer version of the installer is available, it is updated.

1. Select "Advanced Tools" from "Development Tools" in the left menu of App Service.

   

2. Click the "Go" link to access Kudu.

   

3. Select "Debug console" - "CMD" from the Kudu header menu.

   

4. Execute the following command to create a folder in which to place the .nupkg file.
   This procedure explains the case of creating C:\home\dotnet-tools. (Depending on the user, it may be D:\home. In that case, replace the path accordingly.)

   mkdir C:\home\dotnet-tools
   

5. Open the NuGet Gallery page for Implem.PleasanterSetup from here and download the .nupkg file from "Download package" shown in the image.

   

6. Place the .nupkg file downloaded in step 5 in C:\home\dotnet-tools.

7. Execute the following commands.

   dotnet tool install Implem.PleasanterSetup --tool-path C:\home\dotnet-tools --add-source C:\home\dotnet-tools
   set PATH=%PATH%;C:\home\dotnet-tools
   

3. Run the Installer¶

※The installer downloads the latest version resources and ParametersPatch.zip, and runs the upgrade.

1. Run the installer by executing the following command.

   pleasanter-setup
   

2. Enter the directory where Pleasanter is installed.
   If it is installed in "C:\home\site\wwwroot", press the Enter key without entering anything.
   

3. Enter the directory where you want to install CodeDefiner.
   If you want to install it in "C:\home\site\CodeDefiner", press the Enter key without entering anything.
   

4. The summary screen is displayed.
   Check the contents, enter y after "Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. : ", and press the Enter key.
   ※The password is masked.
   
   ※After you enter "y", it may take some time before the process starts. 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, the URL of the Enterprise Edition 90-day trial information page (Japanese) is shown on the screen. A web browser does not open on Azure App Service. Setup is now complete. Continue to the next step.

4. Start Pleasanter¶

1. Open App Service and start the instance.
2. Start your browser and log in to Pleasanter.
3. After logging in, click "Help" - "Version" in the navigation menu and confirm that the version is correct.
   

※If you do not need C:\home\site\wwwroot_yyyyMMdd_HHmmss and C:\home\site\CodeDefiner_yyyyMMdd_HHmmss, which the installer backed up, delete them. If you want to keep them, move them to a different folder.