Migration Procedure from Previous Pleasanter (.NET Core version) Built on CentOS to Pleasanter 1.3 or Later
## Overview
This description is the procedure for migrating .NET Core version of Pleasanter installed on CentOS to Pleasanter 1.3.
|Target|Before migration|After migration|
|---|---|---|
|OS|CentOS|CentOS|
|DB|PostgreSQL|PostgreSQL|
|Web server|Nginx|Nginx|
|Platform|.NET Core|.NET 6.0|
|Pleasanter|.NET Core version (1.1.x.x)|Pleasanter 1.3 (1.3.x.x)|
## Prerequisites
Make sure that Pleasanter installed on CentOS is the .NET Core version.
1. Log in to Pleasanter.
1. Click "Help" in the upper right corner and select "Version".
1. Confirm that the version is "1.1.x.x".
## Notes
1. If you have edited the configuration file of the source environment (under the /web/pleasanter/Implem.Pleasanter/App_Data/Parameters directory), 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.
## Preparation
#### Tools to Use
1. WinSCP and WinMerge are installed on the local PC (Windows).
WinSCP: https://forest.watch.impress.co.jp/library/software/winscp/
WinMerge: https://winmergejp.bitbucket.io/
#### Backup Database
1. Log in to the server where Pleasanter is installed (hereafter, remote PC) and stop Pleasanter with the following command:
```
# systemctl stop pleasanter
```
1. Backup of the Pleasanter database.
[FAQ: PostgreSQL database backup and restore procedure](faq-postgresql-backup-restore)
## Install .NET6.0
1. Log in to the remote PC and execute the following commands:
```
# dnf update
# dnf install -y dotnet-sdk-6.0
```
1. Confirm that it is installed with the following command:
```
# dotnet --version
```
## Download Pleasanter 1.3
1. Start a browser and access the following URL:
https://pleasanter.org/dlcenter
1. Click "Pleasanter 1.3" under "Pleasanter 1.3 Community Edition" and download the file.
## Deploy Modules
1. Start WinSCP on the local PC and connect to the remote PC.
1. Create a working folder (C:\migration) and a backup folder (C:\migration\backup) on the local PC.
1. Use WinSCP to navigate to the "/web" directory on the remote PC.
1. Back up the "/web/pleasanter" directory on the remote PC to "C:\migration\backup" on the local PC.
1. Delete the "/web/pleasanter" directory on the remote PC.
1. Extract the downloaded file to the working folder on the local PC.
1. Start WinMerge and compare the following two folders.
①C:\migration\pleasanter\Implem.Pleasanter\App_Data\Parameters
②C:\migration\backup\pleasanter\Implem.Pleasanter\App_Data\Parameters
1. Compare and modify each parameter file in folder ① above with the corresponding files in folder ② above.
1. Use WinSCP to copy the "C:\migration\pleasanter" folder on the local PC to the "/web" directory on the remote PC.
## Start Pleasanter
1. Log in to the remote PC, start a terminal, and execute the following commands:
```
# cd /web/pleasanter/Implem.CodeDefiner
# dotnet Implem.CodeDefiner.dll _rds
```
1. Start Pleasanter with the following command:
```
# systemctl start pleasanter
```
1. Start your browser and log in to Pleasanter.
1. Click "Help" in the upper right corner and select "Version".
1. Confirm that the version is "1.3.xx."
## Other
#### Restore Database
If you need to restore the database, please refer to the following page:
[FAQ: PostgreSQL database backup and restore procedure](faq-postgresql-backup-restore)
