1.4.8.0以降のバージョンアップ手順(Linux)
概要¶
Linux系OSで運用しているプリザンターver1.4.8.0以降のバージョンアップ手順です。
注意事項¶
- 現在運用中のパラメータファイルを最新バージョンに上書きコピーしないでください。最新バージョンで新たに追加したパラメータが失われ、プリザンターが起動しない恐れがあります。
- Enterprise Editionにアップグレードし項目拡張を実施している場合は、Enterprise Edition - バージョンアップ手順に従ってバージョンアップを実施してください。
- Pleasanter Extensionsのトライアルを実施中の場合は、「Pleasanter Extensionsのトライアルの注意点」を確認してください。
1.CodeDefiner実行時に/l、/zのパラメータを設定しないでください。 - ver.1.4.17.0以降でインストーラによるアップデートおよびマージ機能をご利用の際は、ver.1.4.17.0以降でマージ機能を利用する際の注意事項を確認してください。
制限事項¶
- CodeDefinerのマージ機能は1.4.8.0以降より利用可能です。
- CodeDefinerのマージ機能は、新バージョンで追加および削除されたパラメータを適用します。
- バージョンアップ元は1.4.0.0以降が対象です。
前提条件¶
- プリザンターを起動するユーザが登録されていること。手順の中で記載している <プリザンターを起動するユーザ> はこのユーザを指します。
- 本手順では.NETを /usr/local/bin にインストールする場合として説明します。同一環境に複数バージョンの.NETが必要などの理由で.NETを異なるディレクトリにインストールする場合は、CodeDefinerの実行時やPleasanterサービス用スクリプトの作成でExecStartに指定するディレクトリをインストール先に合わせて変更してください。
手順¶
バージョンアップ手順は以下の通りです。
1. プリザンターの停止
1. データベースのバックアップ
1. プリザンターのバックアップ
1. プリザンターの準備
1. アプリケーションの準備
1. パッチファイルのダウンロード
1. パラメータ再設定
1. CodeDefinerの実行
1. プリザンターの起動確認
1.プリザンターの停止¶
以下コマンドを実行して、プリザンターを停止します。
2. データベースのバックアップ¶
データベースをバックアップします。Enterprise Editionにアップグレードし、項目を拡張している場合は必ずバックアップしてください
Pleasanter ユーザーマニュアル － FAQ：バックアップ、リストア
3. プリザンターのバックアップ¶
既存の/web/pleasanter/を/web/pleasanter_bk/などとリネームしてバックアップします。
4. プリザンターの準備¶
1. アプリケーションの準備¶
- ダウンロードセンターから、プリザンター最新バージョンをダウンロードします。
- ダウンロードしたzipファイルを解凍し/web/配下に解凍します。
/web/ ディレクトリ配下の構成が以下のようになっていることを確認してください。
/web/pleasanter
/web/pleasanter_bk - 以下コマンドを実行して、pleasanterディレクトリ配下の所有者をあらかじめ決めたプリザンターを起動するユーザに変更します。
2. パッチファイルのダウンロード¶
- GitHubのリリースページから、配置したバージョンと同様のバージョンのParametersPatch.zipをダウンロードします。
- ParametersPatch.zipを /web/pleasanter/ ディレクトリ配下に配置します。
/web/pleasanter/ParametersPatch.zip
※ParametersPatch.zipは解凍せずに配置してください。
3. パラメータ再設定¶
/web/pleasanter/Implem.CodeDefinerディレクトリに移動し、CodeDefinerでパラメータのマージ処理を実行します。
> cd /web/pleasanter/Implem.CodeDefiner
> sudo -u <プリザンターを起動するユーザ> /usr/local/bin/dotnet Implem.CodeDefiner.dll merge /b /web/pleasanter_bk /i /web/pleasanter
パラメータのマージ機能については、以下マニュアルページを参照ください。
FAQ：パラメータのマージ機能について
パラメータを手動で再設定する場合
FAQ:パラメータを手動で再設定する手順を知りたい を参照ください
5. CodeDefinerの実行¶
以下コマンドを実行して、あらかじめ決めたプリザンターを起動するユーザでCodeDefinerを実行します。/l、/zの引数設定は不要です。
cd /web/pleasanter/Implem.CodeDefiner
sudo -u <プリザンターを起動するユーザ> /usr/local/bin/dotnet Implem.CodeDefiner.dll _rds
実行確認を求められますので、「y」を入力し、Enterキーを押して実行してください。実行をキャンセルしたい場合は「n」を入力し、Enterキーを押してください。
※Licenseeの表示は環境によって文字化けする可能性があります。
6. プリザンターの起動確認¶
- 以下コマンドを実行して、プリザンターを起動します。
- ブラウザでプリザンターのログイン画面を開き、ログイン後、ナビゲーションメニューの「ヘルプ」－「バージョン」をクリックし、バージョンが正しいことを確認します。
※手順3でバックアップした/web/pleasanter_bkは不要な場合は削除してください。保存しておく場合は別フォルダに退避してください。
対応バージョン¶
| 対応バージョン | 内容 |
|---|---|
| 1.4.8.0 以降 | パラメータのマージ手順追加 |