Skip to content

Migration Procedure from Pleasanter 1.4 Installed on Windows/Windows Server to Pleasanter 1.5

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. You can use this procedure to migrate 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.

Overview

This is the procedure for migrating Pleasanter installed on Windows Server to Pleasanter 1.5.

Target Before migration After migration
OS Windows/Windows Server Windows/Windows Server
DB SQL Server SQL Server
Web Server IIS IIS
Platform .NET 8.0 .NET 10.0
Pleasanter Pleasanter 1.4 Pleasanter 1.5

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

Cautions

  1. Before carrying out this procedure, make a backup of the system and the database.

Advance Confirmation

Confirm the version of Pleasanter installed on Windows/Windows Server.

  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

Backing Up the Database (Windows Server)

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

  2. Select the server name in the left pane, click "Stop" in the right pane, and stop IIS.

    IIS Manager where Stop in the right pane shuts down IIS

  3. Back up the Pleasanter database.
    I want to backup Pleasanter's DB data regularly (SQL Server)

Install .NET 10.0

Warning

Install both "SDK 10.0.x" and "Hosting Bundle" of .NET 10.0.

Procedure

The installation procedure for .NET is as follows.

  1. Install the SDK
  2. Install the Hosting Bundle

Install the SDK

  1. Launch your browser and access the following URL.
    https://dotnet.microsoft.com/download/dotnet/10.0

  2. Download and install "SDK 10.0.x".

    The .NET 10 download page where SDK 10.0.x is chosen

  3. Launch the Command Prompt or PowerShell, run the following command, and confirm that "10.0.x" is displayed.

    dotnet --version
    

Install the Hosting Bundle

  1. Download and install the "Hosting Bundle".

    The download page for the .NET 10 Hosting Bundle

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 the internet, 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 uses C:\dotnet-tools as an example.

    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 showing the Download package link and the install command to copy

  3. Place the .nupkg file you downloaded in step 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
    

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", press the Enter key without entering anything.

    The installer prompt for the directory where Pleasanter is installed

  3. A 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 to run it.
    *The password is masked.

    The installer summary screen where y is entered to proceed

  4. When "Type "y" (yes) if the license is correct, otherwise type "n" (no)." is displayed, enter y and run it.

    <SUCCESS> Starter.ConfigureDatabase: Database configuration has been completed.
    <SUCCESS> Starter.Main: All of the processes have been completed.
    Setup is complete.
    
  5. 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

Check the Connection Strings

If you use SQL Server without a TLS server certificate as the database, such as in a development environment, add TrustServerCertificate=True; to the end of each connection string.

RDS.json (excerpt of the relevant part)
    "SaConnectionString": "Server=(local);Database=master;UID=sa;PWD=<password for the SQL Server sa account>;Connection Timeout=30;TrustServerCertificate=true;",
    "OwnerConnectionString": "Server=(local);Database=#ServiceName#;UID=#ServiceName#_Owner;PWD=<any password>;Connection Timeout=30;TrustServerCertificate=true;",
    "UserConnectionString": "Server=(local);Database=#ServiceName#;UID=#ServiceName#_User;PWD=<any password>;Connection Timeout=30;TrustServerCertificate=true;",

For details, see Notes on Connection Strings When Using SQL Server as the Database in Pleasanter 1.5 and Later.

Start 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 "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