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.

Cautions¶

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.
2. Click "Help" in the upper right corner and select "Version".
3. Confirm that the version is "1.4.x.x".

Preparations¶

Backup Database¶

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.
   

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

Backup Modules¶

1. Rename the existing C:\web\pleasanter to C:\web\pleasanter_bk and back it up.

Install .NET10.0¶

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

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

3. 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".
   

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.

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 and place it in "C:\web\".
2. Download the ParametersPatch.zip for the same version as the one you placed from the GitHub Release Notes and place it in "C:\web\".
3. Confirm that the structure under "C:\web\" is as follows.
   

   C:\web\Pleasanter_1.5.x.x.zip
   C:\web\ParametersPatch.zip
   

4. Execute the following command.
   

   pleasanter-setup -r C:\web\Pleasanter_1.5.x.x.zip -patch C:\web\ParametersPatch.zip
   

5. Enter the directory where Pleasanter is installed.
   If it is installed in "C:\web\pleasanter", press Enter without entering anything.
   
6. 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.
   
7. 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.
   

8. 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.
   

Checking 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.

Start Pleasanter¶

1. Open the "Tools (T)" menu in "Server Manager" and start "Internet Information Services (IIS) Manager".

2. Select "Server name" from the left pane. Click "Start" on the right pane to start IIS.
   

3. After starting, select "Site" - "Default Web Site" from the left pane, click "*.80 (http) Reference" on the right pane, and start Pleasanter.
   

4. After logging in, click "Help" - "Version" in the navigation menu and confirm that the version is correct.