## 概要 本手順は[インストーラ](/ja/manual/getting-started-installer-pleasanter-azure)を使用してプリザンターをバージョンアップする手順です。インストーラを使用すると既存アプリケーションのバックアップ、最新バージョン資源のダウンロードやパラメータのマージなどを自動実行します。 バックアップやモジュールの配置、パラメータのマージを手動で行う今までの手順でもバージョンアップ可能です。手動バージョンアップの手順は以下を参照ください。 [1.4.8.0以降のバージョンアップ手順(Linux)](version-up-linux-1.4.8.0) [プリザンターのバージョンアップ手順(Linux)](version-up-net-core) ## 注意事項 1. Enterprise Editionにアップグレードし項目拡張を実施している場合は、[Enterprise Edition - バージョンアップ手順](https://pleasanter.org/ja/manual?category=8130)に従ってバージョンアップを実施してください。 1. Pleasanter Extentionsの[トライアル](/ja/manual/pleasanter-extensions-trial)を実施中の場合は、本手順によるバージョンアップはできません。詳細は[Pleasanter Extensionsのトライアルの注意点](/ja/manual/pleasanter-extensions-trial-notice)を確認してください。 ## 制限事項 1. バージョンアップ元は1.4.0.0以降が対象です。 1. [インストーラ](/ja/manual/getting-started-installer-pleasanter-azure)を使用したバージョンアップはバージョンアップ元はVer1.4.0.0以降が対象です。Ver1.3.50.2以前をバージョンアップする際は手動バージョンアップの手順を参照ください。 [プリザンターのバージョンアップ手順(Linux)](version-up-net-core) 1. バージョンアップ先は1.4.8.0以降が対象です。 ## 前提条件 1. プリザンターを起動するユーザが登録されていること。手順の中で記載している **<プリザンターを起動するユーザ>** はこのユーザを指します。 ## 手順 バージョンアップ手順は以下の通りです。 1. プリザンターの停止 1. データベースのバックアップ 1. インストーラのインストール 1. インストーラの実行 1. プリザンターの起動確認 ## 1. プリザンターの停止 以下コマンドを実行して、プリザンターを停止します。 ``` sudo systemctl stop pleasanter ``` ## 2. データベースのバックアップ データベースをバックアップします。**Enterprise Editionにアップグレードし、項目を拡張している場合は必ずバックアップしてください** [Pleasanter ユーザーマニュアル － FAQ：バックアップ、リストア](https://pleasanter.org/manual?category=5580) ## 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 ``` ### ネットワーク環境に接続されていない場合は下記手順でインストールしてください。 <details> <summary>（こちらをクリックすると詳細が開閉します） </summary> 1. [こちら](https://www.nuget.org/packages/Implem.PleasanterSetup/) からImplem.PleasanterSetupのNuget Galleryを開き、「Download package」より.nupkgファイルをダウンロードします。  1. 下記コマンドを実行して.nupkgファイルを配置する任意のフォルダを作成します。 ※本手順では/dotnet-toolsを作成する場合として説明します。 ``` sudo mkdir /dotnet-tools ``` 1. 3.1でダウンロードした.nupkgファイルを/dotnet-toolsに配置します。 1. 下記コマンドを実行してインストーラをインストールします。 ``` dotnet tool install -g --add-source /dotnet-tools 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 ``` </details> ## 4. インストーラの実行 ※最新バージョンの資源およびParametersPatch.zipをダウンロードし、バージョンアップを実行します。 1. 以下コマンドを実行して、インストーラを実行します。 ``` pleasanter-setup ``` **ネットワーク環境に接続されていない場合は、下記手順を実施してください** <details> <summary>（こちらをクリックすると詳細が開閉します） </summary> 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/PrametersPatch.zip ``` pleasanter-setup -r /web/Pleasanter_1.4.x.x.zip -patch /web/ParametersPatch.zip ``` </details> 2. プリザンターをインストールするディレクトリを入力します。 「/web/pleasanter」 にインストールする場合は空白で Enter キーを押下してください。  3. **<プリザンターを起動するユーザ>** を入力します。  4. サマリ画面が表示されます。 内容を確認し、「Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. : 」 の後に **y** を入力しEnterキーで実行してください。 ※パスワードはマスクされています。  5. 「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. ``` ## 5. プリザンターの起動確認 1. 以下コマンドを実行して、プリザンターを起動します。 ``` sudo systemctl start pleasanter ``` 2. ブラウザでプリザンターのログイン画面を開き、ログイン後、ナビゲーションメニューの「ヘルプ」－「バージョン」をクリックし、バージョンが正しいことを確認します。  ※インストーラでバックアップされた/web/pleasanter_yyyyMMdd_HHmmssは不要な場合は削除してください。保存しておく場合は別フォルダに退避してください。