コンテンツにスキップ

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

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

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

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

概要

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

注意事項

  1. インストーラを利用する場合、プリザンター 1.5へバージョンアップされます。プリザンター 1.4を利用している場合は、あらかじめ.NET 10をインストールしてください。手順は、次のページの「.NETのセットアップ」を参照してください。.NET 8と同じディレクトリ(/usr/local/bin)にインストールできます。
  2. Enterprise Editionにアップグレードし項目拡張を実施している場合は、Enterprise Edition - バージョンアップ手順に従ってバージョンアップを実施してください。
  3. Enterprise Editionの90日間トライアルを実施中の場合は、「インストーラを使ったトライアル期間中のバージョンアップ」を参照してください。
  4. ver.1.4.17.0以降でインストーラによるアップデートおよびマージ機能をご利用の際は、ver.1.4.17.0以降でマージ機能を利用する際の注意事項を確認してください。

制限事項

  1. インストーラを使用したバージョンアップは、バージョンアップ元がVer1.4.0.0以降のプリザンターが対象です。Ver1.3.50.2以前をバージョンアップする際は、手動バージョンアップの手順を参照してください。
  2. バージョンアップ先は1.4.8.0以降が対象です。CodeDefinerのマージ機能は1.4.8.0以降で利用できます。
  3. 現在より古いバージョンへのダウングレードはできません(「プリザンターのバージョンをダウングレードしたい」)。ネットワークに接続できない場合に、現在より古いバージョンのzipを指定すると、インストーラはプリザンターを置き換えた後に「Invalid Version From:(現在のバージョン) To:(指定したバージョン)」というエラーで終了し、プリザンターが起動しなくなります。その場合は、/web/pleasanter を、インストーラがバックアップした /web/pleasanter_yyyyMMdd_HHmmss に戻してください。

前提条件

  1. プリザンターを起動するユーザを、あらかじめ登録してください。手順の中で記載している <プリザンターを起動するユーザ> はこのユーザを指します。
  2. 本手順では.NETを /usr/local/bin にインストールする場合として説明します。同一環境に複数バージョンの.NETが必要などの理由で.NETを異なるディレクトリにインストールする場合は、CodeDefinerの実行時やPleasanterサービス用スクリプトの作成でExecStartに指定するディレクトリをインストール先に合わせて変更してください。

1⃣ プリザンターの停止

下記のコマンドを実行して、プリザンターを停止します。

sudo systemctl stop pleasanter

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

データベースをバックアップします。手順は「FAQ:バックアップ、リストア」を参照してください。

項目を拡張している場合

Enterprise Editionにアップグレードし、項目を拡張している場合は、必ずバックアップしてください。

3⃣ インストーラのインストール

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

dotnet tool install -g Implem.PleasanterSetup

初めてインストーラを使う場合

手動でインストールしたプリザンターをバージョンアップするなど、初めてインストーラを使う場合は、続けて下記のコマンドを実行してください。インストーラを使ったことがある場合、これらの設定は済んでいるため、実行は不要です。

echo 'export PATH="$PATH:$HOME/.dotnet/tools"' >> ~/.bashrc
echo 'export DOTNET_ROOT=/usr/local/bin' >> ~/.bashrc
echo 'export PATH=$PATH:$DOTNET_ROOT' >> ~/.bashrc
source ~/.bashrc
ネットワークに接続できない場合
  1. 下記のコマンドを実行して、.nupkgファイルを配置するディレクトリを作成します。本手順では /dotnet-tools を作成する場合として説明します。

    sudo mkdir /dotnet-tools
    
  2. NuGet GalleryのImplem.PleasanterSetupのページを開き、画像の①「Download package」から.nupkgファイルをダウンロードします。

    Implem.PleasanterSetupのNuGet Galleryのページ。①「Download package」がある

  3. 手順2でダウンロードした.nupkgファイルを /dotnet-tools に配置します。

  4. 画像の②のコマンドをコピーします。
  5. 下記のコマンドを実行します。手順4でコピーしたコマンドの末尾に --add-source /dotnet-tools を付けたものです。

    dotnet tool install --global Implem.PleasanterSetup --version 1.0.1 --add-source /dotnet-tools
    

    上記はImplem.PleasanterSetupのバージョンが1.0.1の場合の例です。初めてインストーラを使う場合は、続けて「初めてインストーラを使う場合」のコマンドを実行してください。

4⃣ インストーラの実行

インストーラは、最新バージョンのモジュールとParametersPatch.zipをダウンロードし、バージョンアップを実行します。

  1. インストーラを起動します。下記のコマンドを実行してください。

    pleasanter-setup
    
    ネットワークに接続できない場合
    1. ダウンロードセンターから最新バージョンのプリザンターをダウンロードし、/web/に配置してください。
    2. GitHubのリリースページから、配置したバージョンと同じバージョンのParametersPatch.zipをダウンロードし、/web/に配置してください。
    3. /web/ディレクトリ配下の構成が下記のようになっていることを確認してください。

      /web/Pleasanter_1.5.x.x.zip
      /web/ParametersPatch.zip
      
    4. 下記のコマンドを実行してください。

      pleasanter-setup -r /web/Pleasanter_1.5.x.x.zip -patch /web/ParametersPatch.zip
      
  2. プリザンターをインストールしているディレクトリを設定します。
    既定では /web/pleasanter が設定されます。
    Enter キーを押下してください。

    Install Directory [Default: /web/pleasanter] :
     
    
  3. <プリザンターを起動するユーザ> を入力し、Enter キーを押下してください。

    Please enter the user who will execute Pleasanter.
    <プリザンターを起動するユーザ>
    
  4. サマリ画面が表示されます。内容に間違いがないことを確認してください。
    「Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. :」に Y を入力し、Enter キーを押下して実行してください。

    ------ Summary ------
    Install Directory         : /web/pleasanter
    DBMS                      : PostgreSQL
    SaConnectionString PWD    : **********
    OwnerConnectionString PWD : **********
    UserConnectionString PWD  : **********
    Port                      : 5432
    Server                    : localhost
    Service Name              : Implem.Pleasanter
    [Issues]
        Class       :
        Num         :
        Date        :
        Description :
        Check       :
        Attachments :
    [Results]
        Class       :
        Num         :
        Date        :
        Description :
        Check       :
        Attachments :
    ---------------------
    Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. :
    y
    

    パスワードは表示されない

    パスワードはマスクされ、確認することができません。

  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).
    y
    
  6. 下記ログが表示されたらセットアップは終了です。

    <SUCCESS> Starter.ConfigureDatabase: Database configuration has been completed.
    <SUCCESS> Starter.Main: All of the processes have been completed.
    トライアルを開始するには `pleasanter-setup trial` を実行してください。
    トライアルの始め方と、インストール後の次の一歩は、こちらのページをご覧ください。
    https://pleasanter.org/pleasanter-extensions-trial/
    Setup is complete.
    
  7. セットアップが終了すると、WebブラウザでEnterprise Editionの90日間トライアルの案内ページが開きます。Webブラウザを開けない環境(GUIの無いサーバなど)では、案内ページのURLが画面に表示されます。セットアップはこれで完了しています。続けて次の手順に進んでください。

    セットアップの完了後に開くEnterprise Editionの90日間トライアルの案内ページ

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

  1. 下記のコマンドを実行して、プリザンターを起動します。

    sudo systemctl start pleasanter
    
  2. ブラウザでプリザンターのログイン画面を開き、ログイン後、ナビゲーションメニューの「ヘルプ」-「バージョン」をクリックし、バージョンが正しいことを確認します。

    「ヘルプ」-「バージョン」で表示したプリザンターのバージョン情報

バックアップされたディレクトリ

インストーラは、バージョンアップ前のプリザンターを /web/pleasanter_yyyyMMdd_HHmmss にバックアップします。不要な場合は削除してください。保存しておく場合は別のディレクトリに退避してください。