Skip to content

Upgrade Procedure Using the Installer (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.
Pleasanter Version Upgrade Procedure (Azure App Service)

Cautions

  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.
  2. 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".
  3. 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".
  4. 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.

Limitations

  1. The version to be upgraded is 1.4.0.0 or later.
  2. 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)
  3. 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. Install the installer
1. Run the installer
1. Check that Pleasanter is running

1. Stop Pleasanter

  1. Connect to Azure Portal.
  2. Open App Service.
    The Azure Portal where App Service is opened
  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

3. Install the Installer

1. Access Kudu.

  1. Click "Advanced Tools" from "Developer Tools" in the left menu of App Service
    The App Service left menu with Advanced Tools under Developer Tools
  2. Click the "Move" link
    The App Service Advanced Tools page with the link that opens Kudu
  3. Click "Debug console" > "CMD" from the Kudu header menu
    The Kudu header menu with Debug console and CMD

  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 and download the .nupkg file from "Download package".
      The NuGet Gallery page for Implem.PleasanterSetup with 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.3.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

4. 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.
    The installer prompt for the directory where Pleasanter is installed

  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.
    The installer prompt for the directory where CodeDefiner is installed

  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.
    The installer summary screen where y is entered to proceed

    *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.

    The trial information page opened in the browser after setup finishes

5. Check that Pleasanter is running

  1. Open App Service and start the instance.

  2. 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.
    The Pleasanter version information shown from Help - Version

  3. 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.