Skip to content

Upgrade Procedure Using the Installer (Windows)

Support for .NET 8 ended on November 10, 2026

Microsoft support for .NET 8, on which Pleasanter 1.4 runs, ended on November 10, 2026 (.NET and .NET Core official support policy). Pleasanter 1.5 runs on .NET 10. For the steps to migrate from Pleasanter 1.4 to 1.5, see the following pages.

You can also leave the migration work to the developer's engineers. See Pleasanter Version Upgrade and Environment Migration (Japanese) on the product site.

If you use SQL Server as the database in Pleasanter 1.5 or later, be sure to read the following manual page.
Notes on Connection Strings When Using SQL Server as the Database in Pleasanter 1.5 and Later

Overview

This is the procedure for upgrading Pleasanter by using the installer (Install Pleasanter on AlmaLinux Using the Installer). When you use the installer, it automatically backs up the existing application, downloads the resources of the latest version, merges the parameters, and so on.
You can also upgrade with the previous procedure, in which you back up, place the modules, and merge the parameters by hand. For the manual upgrade procedure, refer to the following.
Pleasanter Version Upgrade Procedure (Windows)

Cautions

  1. When you use the installer, Pleasanter is upgraded to Pleasanter 1.5. If you are currently using Pleasanter 1.4, migrate to Pleasanter 1.5 with Migration Procedure from Pleasanter 1.4 Installed on Windows/Windows Server to Pleasanter 1.5.
  2. If you have upgraded to Enterprise Edition and expanded columns, upgrade according to How to Upgrade Pleasanter Enterprise Edition.
  3. If you are running the Pleasanter Extensions Trial of Enterprise Edition (90-day trial), you cannot upgrade with this procedure. For details, check "Notes on the Enterprise Edition 90-day trial".
  4. When you use the update and merge functions of the installer with ver.1.4.17.0 and later, check Precautions When Using the Merge Function in ver.1.4.17.0 and Later.

Limitations

  1. The version you upgrade from must be 1.4.0.0 or later.
  2. For a version upgrade using the installer (Install Pleasanter on AlmaLinux Using the Installer), the version you upgrade from must be Ver1.4.0.0 or later. When you upgrade Ver1.3.50.2 or earlier, refer to the manual upgrade procedure.
    Pleasanter Version Upgrade Procedure (Windows)
  3. The version you upgrade to must be 1.4.8.0 or later.

Procedure

The upgrade procedure is as follows.

  1. Stop Pleasanter
  2. Back up the database
  3. Install the installer
  4. Run the installer
  5. Check that Pleasanter starts

1. Stop Pleasanter

  1. Open the "Tools (T)" menu in "Server Manager" and launch "Internet Information Services (IIS) Manager".

  2. Select "Server name" from the left pane. Click "Stop" in the right pane to stop IIS.

    IIS Manager where Stop in the right pane shuts down IIS

2. Back Up the Database

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

3. Install/Update the Installer

Be sure to run this even if the installer is already installed. If the installer has been upgraded, it is updated.
Run the following command to install the installer.

dotnet tool install -g Implem.PleasanterSetup

If you are not connected to a network environment, install it with the following procedure.

(Click here to open and close the details)
  1. Run the following command to create any folder in which to place the .nupkg file.
    *This procedure assumes that you create C:\dotnet-tools.

    mkdir C:\dotnet-tools
    
  2. Open the NuGet Gallery of Implem.PleasanterSetup from here and download the .nupkg file from (1) "Download package" in the image.

    The NuGet Gallery page for Implem.PleasanterSetup with Download package

  3. Place the .nupkg file you downloaded in step 2.2 in C:\dotnet-tools.

  4. Copy the command at (2) in the image.
  5. Run the following command.

    <the command you copied in step 2.4> --add-source C:\dotnet-tools
    

    Example: when the Version of Implem.PleasanterSetup is 1.0.1

    dotnet tool install --global Implem.PleasanterSetup --version 1.0.1 --add-source C:\dotnet-tools
    

4. Run the Installer

*The resources of the latest version and ParametersPatch.zip are downloaded and the upgrade is run.

  1. Run the following command to run the installer.

    pleasanter-setup
    

    If you are not connected to a network environment, follow the steps below.

    (Click here to open and close the details)
    1. Download the latest version of Pleasanter from the Download Center and place it in C:\web\.

    2. Download the ParametersPatch.zip for the same version as the one you placed from the GitHub releases page, and place it in C:\web\.

    3. Run the following command.
      Confirm that the structure under the C:\web\ directory is as follows.

      C:\web\Pleasanter_1.5.x.x.zip
      C:\web\ParametersPatch.zip
      
      pleasanter-setup -r C:\web\Pleasanter_1.5.x.x.zip -patch C:\web\ParametersPatch.zip
      
  2. Enter the directory where Pleasanter is installed.
    If it is installed in "C:\web\pleasanter", leave it blank and press the Enter key.

    The installer prompt for the directory where Pleasanter is installed

  3. A summary screen is displayed. Check the contents, and if there is no problem, enter y and press the Enter key. The password is masked.

    The installer summary screen where y is entered to proceed

  4. If the process ends with the error "\<ERROR> Starter.ExitIfCertificateError: The TLS certificate of the database server could not be validated." as shown below, no TLS certificate is registered on the SQL Server you are connecting to. Register a TLS certificate on the SQL Server, or fix the connection string by referring to "Notes on Connection Strings When Using SQL Server as the Database in Pleasanter 1.5 and Later", and then run the installer again.

    <INFO> Starter.Main: Implem.CodeDefiner 1.5.6.1
    <ERROR> Starter.ExitIfCertificateError: The TLS certificate of the database server could not be validated.
    'TrustServerCertificate=True;' is not added automatically on version up.
    Add 'TrustServerCertificate=True;' to the ConnectionString in Rds.json or to the environment variable that provides the ConnectionString, or install a certificate that is trusted by this machine on the SQL Server, and run the setup again.
    Implem.CodeDefiner exited with code 100.
    
  5. You are asked to confirm the Edition of Pleasanter to install. For Community Edition, enter y and press the Enter key.

    <INFO> Configurator.OutputLicenseInfo: This edition is "Community Edition".
    Type "y" (yes) if the license is correct, otherwise type "n" (no).
    
  6. When the following log is displayed, the setup is finished.

    <SUCCESS> Starter.ConfigureDatabase: Database configuration has been completed.
    <SUCCESS> Starter.Main: All of the processes have been completed.
    To enable the trial, please run `pleasanter-setup trial`.
    For how to start the trial and the next steps after installation, please visit https://pleasanter.org/pleasanter-extensions-trial/
    Setup is complete.
    
  7. When setup is complete, the Enterprise Edition 90-day trial information page (Japanese) opens in a web browser. Setup is now complete. Continue to the next step.

    The Enterprise Edition 90-day trial information page that opens after setup is complete

5. Check That Pleasanter Starts

  1. Open the "Tools (T)" menu in "Server Manager" and launch "Internet Information Services (IIS) Manager".

  2. Select "Server name" from the left pane. Click "Start" in the right pane to start IIS.

    IIS Manager where Start in the right pane starts IIS

  3. After it starts, select "Sites" - "Default Web Site" from the left pane, click "Browse *.80 (http)" in the right pane, and start Pleasanter.

    IIS Manager opening Pleasanter from Browse *.80 (http) on Default Web Site

  4. After logging in, click "Help" - "Version" in the navigation menu and confirm that the version is correct.

    The Pleasanter version information shown from Help - Version

*If you do not need C:\web\pleasanter_yyyyMMdd_HHmmss backed up by the installer, delete it. If you want to keep it, move it to a different folder.