コンテンツにスキップ

インストーラを利用したバージョンアップ手順(Windows)

.NET 8 のサポートは2026年11月10日に終了します

プリザンター 1.4 が動作する .NET 8 は、2026年11月10日にマイクロソフトによるサポートが終了します(.NET および .NET Core の公式サポート ポリシー)。プリザンター 1.5 は .NET 10 で動作します。プリザンター 1.4 から 1.5 へ移行する手順は、次のページを参照してください。

移行の作業は、開発元のエンジニアに任せることもできます。製品サイトのプリザンターのバージョンアップ・環境移行を参照してください。

プリザンター1.5以降で、DBにSQL Serverを使用する場合は、必ず以下のマニュアルを確認してください。
プリザンター1.5以降でDBにSQL Serverを使用する際の接続文字列についての注意事項

概要

本手順はインストーラを使用してプリザンターをバージョンアップする手順です。インストーラを使用すると既存アプリケーションのバックアップ、最新バージョン資源のダウンロードやパラメータのマージなどを自動実行します。
バックアップやモジュールの配置、パラメータのマージを手動で行う今までの手順でもバージョンアップ可能です。手動バージョンアップの手順は以下を参照ください。
プリザンターのバージョンアップ手順(Windows)

注意事項

  1. インストーラを利用する場合、プリザンター 1.5へバージョンアップされます。現在プリザンター 1.4を利用されている場合は、Windows/Windows Serverにインストールしたプリザンター 1.4をプリザンター 1.5へ移行する手順でプリザンター1.5へ移行してください。
  2. Enterprise Editionにアップグレードし項目拡張を実施している場合は、Enterprise Edition - バージョンアップ手順に従ってバージョンアップを実施してください。
  3. Enterprise Editionの90日間トライアルを実施中の場合は、本手順によるバージョンアップはできません。詳細は「Enterprise Editionの90日間トライアルの注意点」を確認してください。
  4. ver.1.4.17.0以降でインストーラによるアップデートおよびマージ機能をご利用の際は、ver.1.4.17.0以降でマージ機能を利用する際の注意事項を確認してください。

制限事項

  1. バージョンアップ元は1.4.0.0以降が対象です。
  2. インストーラを使用したバージョンアップはバージョンアップ元はVer1.4.0.0以降が対象です。Ver1.3.50.2以前をバージョンアップする際は手動バージョンアップの手順を参照ください。
    プリザンターのバージョンアップ手順(Windows)
  3. バージョンアップ先は1.4.8.0以降が対象です。

手順

バージョンアップ手順は以下の通りです。
1. プリザンターの停止
1. データベースのバックアップ
1. インストーラのインストール
1. インストーラの実行
1. プリザンターの起動確認

1. プリザンターの停止

  1. 「サーバマネージャー」の「ツール(T)」メニューを開き「インターネット インフォメーション サービス(IIS)マネージャー」を起動してください。

  2. 左ペインより「サーバー名」を選択します。右ペインの「停止」をクリックして、IISを停止してください。
    IISマネージャーの画面。右ペインの「停止」でIISを停止する

2. データベースのバックアップ

データベースをバックアップします。Enterprise Editionにアップグレードし、項目を拡張している場合は必ずバックアップしてください
Pleasanter ユーザーマニュアル - FAQ:バックアップ、リストア

3. インストーラのインストール/更新

インストール済みであっても必ず実行してください。インストーラがバージョンアップしている場合は更新インストールします。
下記コマンドを実行して、インストーラをインストールします。

dotnet tool install -g Implem.PleasanterSetup

ネットワーク環境に接続されていない場合は下記手順でインストールしてください。

(こちらをクリックすると詳細が開閉します)
  1. 下記コマンドを実行して.nupkgファイルを配置する任意のフォルダを作成します。
    ※本手順ではC:\dotnet-toolsを作成する場合として説明します。
    mkdir C:\dotnet-tools
    
  2. こちら からImplem.PleasanterSetupのNuget Galleryを開き、画像の①「Download package」より.nupkgファイルをダウンロードします。
    Implem.PleasanterSetupのNuGet Galleryのページ。①「Download package」がある
  3. 手順2.2でダウンロードした.nupkgファイルをC:\dotnet-toolsに配置します。
  4. 画像の②のコマンドをコピーします。
  5. 下記コマンド実行します。
    <手順2.4でコピーしたコマンド> --add-source C:\dotnet-tools
    

例:Implem.PleasanterSetupのVersionが1.0.1の場合

dotnet tool install --global Implem.PleasanterSetup --version 1.0.1 --add-source C:\dotnet-tools

4. インストーラの実行

※最新バージョンの資源およびParametersPatch.zipをダウンロードし、バージョンアップを実行します。

  1. 以下コマンドを実行して、インストーラを実行します。

    pleasanter-setup
    

    ネットワーク環境に接続されていない場合は、下記手順を実施してください

    (こちらをクリックすると詳細が開閉します)
    1. ダウンロードセンターから最新バージョンのプリザンターをダウンロードし、「C:\web\」に配置します。

    2. GitHubのリリースページから、配置したバージョンと同様のParametersPatch.zipをダウンロードして「C:\web\」に配置します。

    3. 下記コマンドを実行します。
      C:\web\ ディレクトリ配下の構成が以下のようになっていることを確認してください。

      C:\web\Pleasanter_1.5.x.x.zip
      C:\web\ParametersPatch.zip
      
      pleasanter-setup -r C:\web\Pleasanter_1.5.x.x.zip -patch C:\web\ParametersPatch.zip
      
  2. プリザンターがインストールされているディレクトリを入力します。
    「C:\web\pleasanter」 にインストールされている場合は空白で Enter キーを押下します。
    インストーラの実行画面。プリザンターのインストール先を入力する

  3. サマリ画面が表示されます。内容を確認し問題なければ y を入力し、Enterキーを押下してください。パスワードはマスクされています。
    インストーラのサマリ画面。内容を確認してyを入力する

  4. 下記のように「\<ERROR> Starter.ExitIfCertificateError: The TLS certificate of the database server could not be validated.」というエラーが表示されて処理が終了した場合は、接続先のSQL ServerにTLS証明書が登録されていません。SQL ServerへTLS証明書を登録するか、「プリザンター1.5以降でDBにSQL Serverを使用する際の接続文字列についての注意事項」を参照して接続文字列を修正した後に、再度インストーラを実行してください。

    <INFO> Starter.Main: Implem.CodeDefiner 1.5.6.1
    <ERROR> Starter.ExitIfCertificateError: The TLS certificate of the database server could not be validated.
    'TrustServerCertificate=True;' is not added automatically on version up.
    Add 'TrustServerCertificate=True;' to the ConnectionString in Rds.json or to the environment variable that provides the ConnectionString, or install a certificate that is trusted by this machine on the SQL Server, and run the setup again.
    Implem.CodeDefiner exited with code 100.
    
  5. インストールするプリザンターのEditionについて確認されます。Community Editionの場合は y を入力し、Enterキーを押下してください。

    <INFO> Configurator.OutputLicenseInfo: This edition is "Community Edition".
    Type "y" (yes) if the license is correct, otherwise type "n" (no).
    
  6. 下記のログが表示されたらセットアップは終了です。

    <SUCCESS> Starter.ConfigureDatabase: Database configuration has been completed.
    <SUCCESS> Starter.Main: All of the processes have been completed.
    To enable the trial, please run `pleasanter-setup trial`.
    For reference, visit https://pleasanter.org/pleasanter-extensions-trial/.
    Setup is complete.
    
  7. セットアップが終了すると、Webブラウザが起動してEnterprise Editionの90日間トライアルの案内ページが表示されます。

    セットアップ後に開くPleasanter Extensionsトライアルの案内ページ

5. プリザンターの起動確認

  1. 「サーバマネージャー」の「ツール(T)」メニューを開き「インターネット インフォメーション サービス(IIS)マネージャー」を起動します。

  2. 左ペインより「サーバー名」を選択します。右ペインの「開始」をクリックして、IISを開始します。
    IISマネージャーの画面。右ペインの「開始」でIISを開始する

  3. 開始後、左ペインより「サイト」-「Default Web Site」を選択し、右ペインの「*.80(http)参照」をクリックし、プリザンターを起動します。
    IISマネージャー。「Default Web Site」の「*.80(http)参照」でプリザンターを開く

  4. ログイン後、ナビゲーションメニューの「ヘルプ」-「バージョン」をクリックし、バージョンが正しいことを確認します。
    「ヘルプ」-「バージョン」で表示したプリザンターのバージョン情報

※インストーラでバックアップされたC:\web\pleasanter_yyyyMMdd_HHmmssは不要な場合は削除してください。保存しておく場合は別フォルダに退避してください。