User Manual

01.13.2026

MANUAL

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

## Overview This is the procedure for migrating a Windows Server installed Pleasanter 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 | ## Notes 1. Before carrying out this procedure, please make a backup of the system and database. ## Advance Confirmation Confirm the version of Pleasanter installed on Windows/Windows Server. 1. Log in to Pleasanter. 1. Click "Help" in the upper right corner and select "Version". 1. Confirm that the version is "1.4.x.x". ## Preparation #### Backup Database 1. Open the "Tools" menu of "Server Manager" and launch "Internet Information Services (IIS) Manager". 1. Select the server name in the left pane, click "Stop" in the right pane, and stop IIS. ![image](https://pleasanter.org/binaries/deb068434b1b40248d91f67c1b4ba992) 1. Back up the Pleasanter database. [FAQ: I want to backup Pleasanter' DB data regularly (SQL Server)](faq-backup-schedule) #### Backup Modules 1. Rename the existing C:\web\pleasanter to C:\web\pleasanter_bk and back it up. ## Install .NET10.0 <b><font color="red">Please install both the "SDK 10.0.x" of .NET10.0 and "Hosting Bundle".</font></b> ## Procedure The installation procedure for .NET is as follows: 1. Install the SDK 1. Install the Hosting Bundle ## Install the SDK 1. Launch your browser and access the following URL.  https://dotnet.microsoft.com/download/dotnet/10.0 1. Download and install "SDK 10.0.x". ![image](https://pleasanter.org/binaries/5b3412af3dc848d6a0cc1d3e69c458fc) 1. Launch the Command Prompt or PowerShell and execute the following command to confirm that "10.0.x" is displayed. ``` dotnet --version ``` ## Install the Hosting Bundle 1. Download and install the "「Hosting Bundle」". ![image](https://pleasanter.org/binaries/ed13b73ebb1c44f5b2479fefd7c2db69) ## Installing/Updating the Installer **Even if already installed, please be sure to execute this. If the installer has been upgraded, it will perform an update installation.** Execute the following command to install the installer. ``` dotnet tool install -g Implem.PleasanterSetup ``` If not connected to the internet, please install using the following procedure. <details> <summary>(Click here to expand/collapse details)</summary> 1. Execute the following command to create an arbitrary folder to place the .nupkg file. ※This procedure explains the case of creating C:\dotnet-tools. ``` mkdir C:\dotnet-tools ``` 1. Open the Nuget Gallery for Implem.PleasanterSetup from [here](https://www.nuget.org/packages/Implem.PleasanterSetup/) and download the .nupkg file from ① "Download package" in the image. ![image](https://pleasanter.org/binaries/3ec2711d699e4c9eb1f978122e9bb5fc) 1. Place the .nupkg file downloaded in step 2.2 in **C:\dotnet-tools**. 1. Copy the command from ② in the image. 1. Execute the following command. ``` <Command copied in step 2.4> --add-source C:\dotnet-tools ``` **Example: When Implem.PleasanterSetup Version is 1.0.1** ``` dotnet tool install --global Implem.PleasanterSetup --version 1.0.1 --add-source C:\dotnet-tools ``` </details> ## Executing the Installer Download the latest version resources and ParametersPatch.zip, and execute the version upgrade. 1. Execute the following command to run the installer. ``` pleasanter-setup ``` If not connected to the internet, please follow these steps. 1. Download the latest version of Pleasanter from the [Download Center](https://pleasanter.org/dlcenter) and place it in "C:\web\". 1. Download the ParametersPatch.zip for the same version as the one you placed from the [GitHub Release Notes](https://github.com/Implem/Implem.Pleasanter/releases) and place it in "C:\web\". 1. Confirm that the structure under "C:\web\" is as follows. ``` C:\web\Pleasanter_1.5.x.x.zip C:\web\PrametersPatch.zip ``` 1. Execute the following command. ``` 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 Enter without entering anything. ![image](https://pleasanter.org/binaries/3bb5261ce8ed46b690f5459d9580f8a2) 3. A summary screen will be displayed. Review the content and enter **y** after "Shall I install Pleasanter with this content? Please enter 'y(yes)' or 'n(no)'. : " and press Enter to execute. The password is masked. ![image](https://pleasanter.org/binaries/42b7cde127384f66b8d4f167761d599a) 4. When "Type "y" (yes) if the license is correct, otherwise type "n" (no)." is displayed, enter **y** to execute. ``` <SUCCESS> Starter.ConfigureDatabase: Database configuration has been completed. <SUCCESS> Starter.Main: All of the processes have been completed. Setup is complete. ``` 5. For installer version 1.1.2 (Implem.PleasanterSetup.1.1.2.nupkg) and later, when setup is complete, a web browser will launch and display the [Pleasanter Extensions Trial information page](https://pleasanter.org/pleasanter-extensions-trial/?utm_source=installer&utm_medium=app&utm_campaign=extension-trial&utm_content=route01&_gl=1*1yskiwt*_ga*MTM3OTgwMzk2My4xNzYwNjg2Mzc2*_ga_FHETHGLQJE*czE3Njc1NzA3OTkkbzEyMiRnMSR0MTc2NzYwMjMxMyRqNDUkbDAkaDA.). ![image](https://pleasanter.org/binaries/2f1b98e366bb4477bd5ab45e7d4aa8c0) ## Start Pleasanter 1. Open the "Tools (T)" menu in "Server Manager" and start "Internet Information Services (IIS) Manager". 1. Select "Server name" from the left pane. Click "Start" on the right pane to start IIS. ![image](https://pleasanter.org/binaries/1fb50733a47b423591b1490ba1c8a272) 1. After starting, select "「Site」" - "Default Web Site" from the left pane, click "*.80 (http) Reference" on the right pane, and start Pleasanter. ![image](https://pleasanter.org/binaries/5be4e5794d5941d2b31a51f81a26e0a4) 1. After logging in, click "Help" - "Version" in the navigation menu and confirm that the version is correct. ![image](https://pleasanter.org/binaries/1c02fedbb9624738817c0e69453dd1e6)
TOP