Skip to content

Migration Procedure from .netFramework Version of Pleasanter 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 Framework4.7/4.8 .NET 10.0
Pleasanter Pleasanter 0.50 or earlier Pleasanter 1.5

Cautions

  1. Before carrying out this procedure, please make a backup of the system and database.
  2. If you have edited the configuration file of the source environment (under the C:\inetpub\wwwroot\pleasanter\App_Data\Parameters folder), do not overwrite it to the destination environment. If you overwrite it as is, it is possible that the newly added parameters are lost, so please use a diff tool such as WinMerge to merge only the changes into the new parameter file. WinMerge is used in this procedure.

Pre-installation Checklist

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

  1. Log in to Pleasanter.
  2. Click "Help" in the upper right corner and select "Version".
  3. Confirm that the version is "0.50.x.x (or 0.49.x.x)".

Preparations

Tools to Use

  1. WinMerge must be installed. It can be downloaded from the following page.
    　https://winmerge.org/downloads/?lang=en

Backup Database

  1. Open the "Tools (T)" menu in "Server Manager" and start "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.
    FAQ: I want to backup Pleasanter's DB data regularly (SQL Server)

Download Pleasanter 1.5

  1. Access the following URL:
    　https://pleasanter.org/dlcenter

  2. Download Pleasanter from the "Pleasanter 1.5 Community Edition" link.

Deploy Modules

  1. Extract the downloaded Pleasanter module to the "C:\web" folder.

  2. Start WinMerge and compare the following two folders.
    　①C:\web\pleasanter\Implem.Pleasanter\App_Data\Parameters
    　②C:\inetpub\wwwroot\pleasanter\App_Data\Parameters

WinMerge comparing the old and new Parameters folders

  1. Compare and modify each parameter file in folder ① above with the corresponding files in folder ② above.
    *If you are not using extended features, there is no need to change the JSON files inside folders such as "Extended○○".

WinMerge comparing the contents of a parameter file so it can be edited

When modifying parameters, the following parameters must be modified to match the source environment. Set Dbms to "SQLServer" and TimeZone to "UTC".

Rds.json

"Dbms": "SQLServer"
"TimeZoneInfo": "UTC"

Service.json

"TimeZoneDefault": "UTC"

Execute CodeDefiner

  1. Start a command prompt and run the following command.
    cd C:\web\pleasanter\Implem.CodeDefiner
dotnet Implem.CodeDefiner.dll _rds

Start Pleasanter

  1. Start IIS Manager, select the virtual directory of Pleasanter before migration from the left pane (by default, Server Name > Site > Default Web Site > Pleasanter), and click "Basic Settings" in the right pane.
    IIS Manager with the Pleasanter virtual directory selected and Basic Settings

  2. Edit the physical path to "C:\web\pleasanter\Implem.Pleasanter" and click "OK".
    The Basic Settings dialog where the physical path is changed to the new folder

  3. In the left pane, select the server name > Application Pool, then select "Default App Pool" in the center pane, and click "Basic Settings" on the right pane.
    The IIS application pool list with Default App Pool selected

  4. Select "No Managed Code" for ".Net CLR Version" and click "OK".
    The application pool Basic Settings dialog for choosing the .Net CLR Version

  5. Start IIS Manager and IIS.
    IIS Manager where IIS is started again

  6. Start a browser and make sure you can log in to Pleasanter.