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

2026-09-172026-09-17

概要¶

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

注意事項¶

インストーラを利用する場合、プリザンター 1.5へバージョンアップされます。プリザンター 1.4利用時は、あらかじめ.NET10をインストールしてください。手順は「インストーラでプリザンターをUbuntuにインストールする」の「1. .NETのセットアップ」を参照してください。
Enterprise Editionにアップグレードし項目拡張を実施している場合は、Enterprise Edition - バージョンアップ手順に従ってバージョンアップを実施してください。
Pleasanter Extensionsのトライアルを実施中の場合は、本手順によるバージョンアップはできません。詳細は「Pleasanter Extensionsのトライアルの注意点」を確認してください。
ver.1.4.17.0以降でインストーラによるアップデートおよびマージ機能をご利用の際は、ver.1.4.17.0以降でマージ機能を利用する際の注意事項を確認してください。

制限事項¶

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

前提条件¶

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

手順¶

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

1. プリザンターの停止¶

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

sudo systemctl stop pleasanter

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

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

3. インストーラのインストール¶

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

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

dotnet tool install -g Implem.PleasanterSetup
echo 'export PATH="$PATH:~/.dotnet/tools"' >> ~/.bashrc
echo 'export DOTNET_ROOT=/usr/local/bin' >> ~/.bashrc
echo 'export PATH=$PATH:$DOTNET_ROOT' >> ~/.bashrc
source ~/.bashrc

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

（こちらをクリックすると詳細が開閉します）

下記コマンドを実行して.nupkgファイルを配置する任意のフォルダを作成します。
※本手順では/dotnet-toolsを作成する場合として説明します。
```
sudo mkdir /dotnet-tools
```
こちらからImplem.PleasanterSetupのNuget Galleryを開き、画像の①「Download package」より.nupkgファイルをダウンロードします。
手順2.2でダウンロードした.nupkgファイルを/dotnet-toolsに配置します。
画像の②のコマンドをコピーします。

下記コマンド実行します。

<手順2.4でコピーしたコマンド> --add-source /dotnet-tools
echo 'export PATH="$PATH:~/.dotnet/tools"' >> ~/.bashrc
echo 'export DOTNET_ROOT=/usr/local/bin' >> ~/.bashrc
echo 'export PATH=$PATH:$DOTNET_ROOT' >> ~/.bashrc
source ~/.bashrc

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

dotnet tool install --global Implem.PleasanterSetup --version 1.0.1 --add-source /dotnet-tools
echo 'export PATH="$PATH:~/.dotnet/tools"' >> ~/.bashrc
echo 'export DOTNET_ROOT=/usr/local/bin' >> ~/.bashrc
echo 'export PATH=$PATH:$DOTNET_ROOT' >> ~/.bashrc
source ~/.bashrc

4. インストーラの実行¶

※最新バージョンの資源およびParametersPatch.zipをダウンロードし、バージョンアップを実行します。
1. 以下コマンドを実行して、インストーラを実行します。

pleasanter-setup

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

（こちらをクリックすると詳細が開閉します）

1. [ダウンロードセンター](https://pleasanter.org/dlcenter)から最新バージョンのプリザンターをダウンロードし、「/web/」に配置します。 1. [GitHubのリリースページ](https://github.com/Implem/Implem.Pleasanter/releases)から、配置したバージョンと同様のParametersPatch.zipをダウンロードして「/web/」に配します 1. 下記コマンドを実行します。 **/web/** ディレクトリ配下の構成が以下のようになっていることを確認してください。 /web/Pleasanter_1.4.x.x.zip /web/ParametersPatch.zip

pleasanter-setup -r /web/Pleasanter_1.4.x.x.zip -patch /web/ParametersPatch.zip

プリザンターをインストールするディレクトリを入力します。
「/web/pleasanter」にインストールする場合は空白で Enter キーを押下してください。
<プリザンターを起動するユーザ> を入力します。
サマリ画面が表示されます。
内容を確認し、「Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. : 」の後に y を入力しEnterキーで実行してください。
※パスワードはマスクされています。

「Type "y" (yes) if the license is correct, otherwise type "n" (no).」と表示されたら y を入力して実行してください。

<SUCCESS> Starter.ConfigureDatabase: Database configuration has been completed.
<SUCCESS> Starter.Main: All of the processes have been completed.
Setup is complete.

セットアップが終了すると、Webブラウザが起動してEnterprise Editionトライアルの案内ページが表示されます。

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

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

sudo systemctl start pleasanter

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

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