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.
- Migration Procedure from Pleasanter 1.4 Installed on Windows/Windows Server to Pleasanter 1.5
- Procedure for Migrating Pleasanter 1.4 Installed on Ubuntu to Pleasanter 1.5
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¶
- 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.
- If you have upgraded to Enterprise Edition and expanded columns, upgrade according to How to Upgrade Pleasanter Enterprise Edition.
- 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".
- 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¶
- The version you upgrade from must be 1.4.0.0 or later.
- 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) - The version you upgrade to must be 1.4.8.0 or later.
Procedure¶
The upgrade procedure is as follows.
- Stop Pleasanter
- Back up the database
- Install the installer
- Run the installer
- Check that Pleasanter starts
1. Stop Pleasanter¶
-
Open the "Tools (T)" menu in "Server Manager" and launch "Internet Information Services (IIS) Manager".
-
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 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.
If you are not connected to a network environment, install it with the following procedure.¶
(Click here to open and close the details)
-
Run the following command to create any folder in which to place the .nupkg file.
*This procedure assumes that you create C:\dotnet-tools. -
Open the NuGet Gallery of Implem.PleasanterSetup from here and download the .nupkg file from (1) "Download package" in the image.
-
Place the .nupkg file you downloaded in step 2.2 in C:\dotnet-tools.
- Copy the command at (2) in the image.
-
Run the following command.
Example: when the Version of Implem.PleasanterSetup is 1.0.1
4. Run the Installer¶
*The resources of the latest version and ParametersPatch.zip are downloaded and the upgrade is run.
-
Run the following command to run the installer.
If you are not connected to a network environment, follow the steps below.
(Click here to open and close the details)
-
Download the latest version of Pleasanter from the Download Center and place it in
C:\web\. -
Download the ParametersPatch.zip for the same version as the one you placed from the GitHub releases page, and place it in
C:\web\. -
Run the following command.
Confirm that the structure under theC:\web\directory is as follows.
-
-
Enter the directory where Pleasanter is installed.
If it is installed in "C:\web\pleasanter", leave it blank and press the Enter key. -
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.
-
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. -
You are asked to confirm the Edition of Pleasanter to install. For Community Edition, enter y and press the Enter key.
-
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. -
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.
5. Check That Pleasanter Starts¶
-
Open the "Tools (T)" menu in "Server Manager" and launch "Internet Information Services (IIS) Manager".
-
Select "Server name" from the left pane. Click "Start" in the right pane to start IIS.
-
After it starts, select "Sites" - "Default Web Site" from the left pane, click "Browse *.80 (http)" in the right pane, and start Pleasanter.
-
After logging in, click "Help" - "Version" in the navigation menu and confirm that the version is correct.
*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.







