Skip to content

Version Upgrade Procedure During the Pleasanter Extensions Trial (Windows)

Overview

These are the steps to upgrade the version of a Pleasanter that is running the Pleasanter Extensions Trial (hereafter the trial), using the installer of version 1.2.0 or later.

This procedure upgrades the version of Pleasanter using the installer. The installer automatically backs up the existing application, downloads the resources of the latest version, merges the parameters and so on.
You can also upgrade the version with the previous procedure, in which you back up, place the modules and merge the parameters by hand. For the manual version upgrade procedure, refer to the following.
Pleasanter Version Upgrade Procedure (Windows)

Precautions

  1. When you use the update and merge functions of the installer with ver.1.4.17.0 and later, check Precautions When Using the Merge Function in ver.1.4.17.0 and Later.

Limitations

  1. The version you upgrade from must be 1.4.0.0 or later.
  2. For a version upgrade using the installer, the version you upgrade from must be Ver1.4.0.0 or later. When you upgrade from Ver1.3.50.2 or earlier, refer to the manual version upgrade procedure.
    Pleasanter Version Upgrade Procedure (Windows)
  3. The version you upgrade to must be 1.4.8.0 or later.
  4. The /e option cannot be used.

Steps

The version upgrade steps are as follows.

  1. Stopping Pleasanter
  2. Backing up the database
  3. Installing the installer
  4. Running the installer
  5. Checking that Pleasanter starts

1. Stopping Pleasanter

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

  2. Select the "server name" in the left pane. Click "Stop" in the right pane to stop IIS.
    Selecting the server name in IIS Manager and clicking "Stop"

2. Backing Up the Database

Back up the database. For the backup steps, refer to the following.

FAQ: How to backup and restore Pleasanter's DB data

3. Installing / Updating the Installer

Run this even if it is already installed. If the installer has been upgraded, it is updated.
Run the command below to install the installer.

dotnet tool install -g Implem.PleasanterSetup

If you are not connected to a network environment, install it with the steps below.

(Click here to open and close the details)
  1. Run the command below to create any folder in which to place the .nupkg file.
  2. These steps assume that you create C:\dotnet-tools.
    mkdir C:\dotnet-tools
  3. 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 of Implem.PleasanterSetup, with (1) Download package and (2) the command
  4. Place the .nupkg file you downloaded in step 2.2 in C:\dotnet-tools.
  5. Copy the command at (2) in the image.
  6. Run the command below.
    <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

4. Running the Installer

  • The resources of the latest version and ParametersPatch.zip are downloaded and the version upgrade is run.

  • Run the command below 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 centre](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 releases page](https://github.com/Implem/Implem.Pleasanter/releases), and place it in "C:\web\". 1. Run the command below. Confirm that the structure under the **C:\web\** directory is as follows. C:\web\Pleasanter_1.4.x.x.zip C:\web\ParametersPatch.zip ``` pleasanter-setup -r C:\web\Pleasanter_1.4.x.x.zip -patch C:\web\ParametersPatch.zip ```

  • Enter the directory in which Pleasanter is installed.
    If it is installed in "C:\web\pleasanter", leave it blank and press the Enter key.
    The prompt for entering the directory in which Pleasanter is installed

  • The summary screen is displayed.
    Check the content, 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.

  • Passwords are masked.
    The summary screen of the installer

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

  • With an installer of version 1.1.2 (Implem.PleasanterSetup.1.1.2.nupkg) or later, when the setup finishes a web browser starts and the Pleasanter Extensions Trial information page is displayed.

    The Pleasanter Extensions Trial information page opened in a browser after setup

5. Checking That Pleasanter Starts

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

  2. Select the "server name" in the left pane. Click "Start" in the right pane to start IIS.
    Selecting the server name in IIS Manager and clicking "Start"

  3. After it starts, select "Sites" - "Default Web Site" in the left pane, click "Browse *.80 (http)" in the right pane, and start Pleasanter.
    Clicking "Browse *.80 (http)" for Default Web Site in IIS Manager

  4. After you log in, click "Help" - "Version" on the navigation menu and confirm that the version is correct.
    The Pleasanter version shown from "Help" - "Version" on the navigation menu

  5. Delete C:\web\pleasanter_yyyyMMdd_HHmmss, backed up by the installer, if you do not need it. If you keep it, move it to a different folder.