TURNKEYGNU / LINUX
日本語

ドキュメント

オレンジフン

OrangeHRM アップグレード

想定と制限

OrangeHRMとTurnKeyベースOS

このドキュメントは、OrangeHRM v4.x (TurnKey v17.x) および/または OrangeHRM v5.x (TurnKey v18.x) を最新の安定させた OrangeHRM リリース (v5.7 の書き込み時に) に明示的にカバーします。 は、 名称: NOT カバーは、最新のリリースにTurnKey/Debian OSを基調とした。

TurnKey v17.x は Debian 11/Bullseye に基づいています。Bullseye は現在「LTS」に存在しており、セキュリティ更新を少なくとも最長で受けられます。 2026年(平成20年)8月31日. TurnKey v18.xはDebian 12/Bookwormに基づいています。 少なくともまで、ブックワームはサポートされます 2028年6月30日.

このドキュメントも想定しています。

  • TKLBAM が有効になっています(または有効に) - 必要ではありませんが、強くお勧めします。
  • アップグレードには、サーバーに十分な空き容量が2GBありますが、より効果的です。

このドキュメントは、ほとんどのプロセスでターミナルコマンドを使用します。Webmin では、多くの手順が実行可能ですが、ターミナルコマンドは簡潔で、コピー/ペーストされるので、フォローがとても簡単です。 Webminで同じ結果を達成する方法を知っている任意の手順は、代わりにそれを使用するように自由に感じます。

TurnKeyサーバのCLIを「SSH」(安全なシェル)でアクセスすることを推奨します。 最近のWindows 11リリース、Mac OSXとすべてのLinuxデスクトップは、OpenSSHクライアントがプリインストールしたすべての船を風味付けますが、いくつかの代替SSHクライアントもうまく機能します。

または、TurnKey v17.x で、サーバーの「Webshell」をブラウザで使用できます。https はポート 12320 です。 例: https://your.domain.com:12320. TurnKey v18.xでは、Webmin の「プロパー」のインタラクティブなターミナルモジュール(v18.x は WebShell を含んでいません) を使うことができます。

TurnKey v17.x Webmin 端末を使ってください! 実際の端末ではなく、問題が発生します。

一般的にローカルSSHクライアントは、より良いユーザーエクスペリエンスを提供します(例えば、 コピー/ペーストは確実に機能する必要がありますが、v17.xのWebshellまたはv18.xのWebminインタラクティブ端末モジュールは正常に動作する必要があります。

SSHセッションを起動するには:

ssh root@DOMAIN_OR_PUBLIC_IP

パスワードの代わりに認証キーを使用している場合は、ローカルシステムにプライベートキーへのパスを明示的に含める必要があります。

# Linux/OSX
ssh -i ~/path/to/my_private_key root@DOMAIN_OR_PUBLIC_IP

# Windows
C:\Users\ME\path\to\my_private_key root@DOMAIN_OR_PUBLIC_IP

AWSマーケットプレースユーザー向け

AWS Marketplaceインスタンスはデフォルトで「root」アカウントが無効になっています。そのため、 ルートを有効にする または「admin」としてログインし、このようにrootになります。

sudo su -

最初のステップ - 準備

OrangeHRM アップグレードを開始する前に、現在のバックアップと十分な空き容量を確保します。 システムパッケージをアップグレードし、アップグレードを開始する前にシステムを再起動することをお勧めします。

バックアップ

「スナップショット」と「プロパー」のバックアップを両方作成することをお勧めします。 スナップショットは技術的にバックアップではなく、スナップショットをロードするのは、必要に応じて、今すぐどこにいるかを正確に取得するための迅速で簡単な方法です。

TurnKey Hub 経由でサーバーが実行されている場合は、ハブのハブのスナップショットをトリガーできます。 「サーバー」ページ. 完了までに時間がかかる場合がありますのでご注意ください。他の仮想化/クラウドプラットフォームには、この機能も備えています。もし、その機能がわからない場合は、関連するドキュメントを参照してください。 ベアメタルサーバーは、このようなツールを使用することができます クラニラ.

TKLBAM を使用していると仮定すると、手動でサーバーのフル TKLBAM バックアップをトリガーします。Webmin 経由で、または端末を介して行うこともできます。

tklbam-backup --full-backup now

空きスペースや清掃を必要とすれば、

空きスペースを点検するため:

df -h /

出力例(Hub サーバ 10GB のルートボリューム)

Filesystem                Size   Used Avail Use% Mounted on
/dev/xvda                 10.0G  2.1G  8.0G  21% /

「Avail」列(上記例の8.0G)を見てください。少なくとも1GBのバールの最小空き容量が2GB以上推奨されます。 もしも十分でない場合は、まずは以下のようにクリーンアップします。NOTは、次の2番目の(オートロック)コマンドで「y」をブラインドで入力してください。

apt clean
apt autoremove

「オートレモーヴ」コマンドは、古いカーネルを含むいくつかのパッケージのみをリストする必要があります(「linux-image」で始まるパッケージ)。 パッケージの数が多いか、コアパッケージをリストアップする場合は、必ずその機能をチェックし、もし何かの懸念を起こせば、手動で表示されるパッケージを削除できます。 「apt remove PKG1 PKG2 ...」 を使用して削除する安全です。 懸念事項があり、十分な空き容量がある場合、この手順を今すぐスキップしてください。

アップグレードOSソフトウェア(オプション)

最新バージョンにシステムソフトウェアを更新するには:

apt update
apt upgrade

この手順を実行している場合は、上記のapt cleanupコマンドを再実行し、サーバーを再起動し、空きスペースを2倍にチェックしてください。

手動ローカルバックアップ(任意)

スナップショットとTKLBAMバックアップの両方で、 別の バックアップは上書きのように見えるかもしれませんが、冗長層の複数の層が常に望ましいと私は思います。 何かが間違っている場合は、複数の回復オプションと機能を復元するためのパスウェイがあります。 限り、このステップは純粋にオプションで、スナップショットと完全なTKLBAMバックアップは十分な回復オプションを提供します。

マニュアルDBダンプ

mysqldump orangehrm > orangehrm_db.sql.orig

アップグレード OrangeHRM v4.x に v4.10.1

ライティング時に最新のOrangeHRMリリースがv5.7です。しかし、v4.10.1(最新のv4.xリリース)を実行してv5.xにアップグレードする必要があります。 既にv4.10.1以降を実行している場合は、この手順をスキップしてください。

OrangeHRM の提供 アップグレードのドキュメント もう少し詳しく説明して、TurnKey のステップバイステップをここに提供します。

v4.10.1 をダウンロード

wget https://sourceforge.net/projects/orangehrm/files/stable/4.10.1/orangehrm-4.10.1.zip

既存のインストールの移動

mv /var/www/orangehrm /var/www/orangehrm.orig

新規バージョンを解凍

unzip orangehrm-4.10.1.zip
mv orangehrm-4.10.1 /var/www/orangehrm

必要な OrangeHRM ファイルへのアクセスを Webserver に書き込む:

chown -R www-data:www-data /var/www/orangehrm/lib/{confs,logs}
chown -R www-data:www-data /var/www/orangehrm/symfony/{config,apps/orangehrm,cache,log}

既存のDB 'orangehrm'ユーザパスワード (古い設定ファイルから) を取得します。

grep -m 1 password /var/www/orangehrm.orig/symfony/config/databases.yml

php zip 拡張機能をインストールして有効にします。

apt install --yes php-zip
systemctl restart apache2

アップグレードページをWebブラウザにロードする

お使いのWebブラウザで開くと、OrangeHRMサイトのドメインの「アップグレード」ページを参照します。

https://DOMAIN_OR_PUBLIC_IP/upgrader/web

担当:

https://orangehrm.domain.com/upgrader/web

「クリーン」インストールDO NOTをしたいだけに「/upgrader/web」URLなしでドメインをロードします。 それ以外の場合は、既存のデータを上書きします。

DBの詳細を入力してください

Host*:          127.0.0.1
Port:           3306
Username*       orangehrm
Password        <password from the above 'grep' command>
Database Name:  orangehrm

それから「進む」ボタンをかちりと鳴らして下さい。

システムチェック

すべてがうまくいけば、システムチェックページにある各行に緑色の「OK」があることをダブルチェックします。

すべてを想定して、"Proceed" ボタンをクリックします。

現在のOrangeHRMバージョンを選択

ドロップダウンから、現在の/古いOrangeHRMバージョンを選択します。 既にアップグレードされていない限り、TurnKey v17.1はOrangeHRMバージョン'4.9'を持っているはずです。 特に、このコマンドで現在の/古いバージョンを確認することができます。

grep -m 1 'OrangeHRM ver' /var/www/orangehrm.orig/CHANGELOG.TXT

デフォルトでは、戻り値が返されるはずです。

New & Changed Features for OrangeHRM ver 4.9

関連するバージョンを選択し、「送信」ボタンをクリックします。

マニュアルの変更を適用 - 必要に応じて

次のページでは、実行する必要がある手動のステップ/変更が表示されます。 私のテスト中に、データ暗号化にのみ適用される追加のマニュアルステップ。

データの暗号化を有効にしている場合は、古いOrangeHRMディレクトリから暗号化キーをコピーします。

cp /var/www/orangehrm.orig/lib/confs/cryptokeys/key.ohrm /var/www/orangehrm/lib/confs/cryptokeys/

追加のマニュアルの手順を実行したら、「送信」ボタンをクリックします。

データベースの更新

次のページでは、実際にデータベースのアップグレードを実行します。 注意して、アップグレードはしばらく時間がかかるかもしれませんが、進捗が100%に達し、開始ボタンが変更されるまで、そのページを閉じたり、リロードしないことが重要です。 「プロシード」ボタン。

「スタート」ボタンをクリックし、完了したら「送信」ボタンを押します。

新規設定ファイルを作成する

次のページでは、新しいコンフィグファイルを生成します。 このステップは、以前のデータベースのアップグレードページでは、長いが、そのページを閉じたり、リロードしたりするべきではありません。

「スタート」ボタンをクリックし、完了したら「送信」ボタンを押します。

アップグレードの最終更新

オレンジHRM v4.1 を実行していると指摘して、 "Congratulations!" というページで挨拶する必要があります。

このページに示すように、マニュアルの手順が完成していることを確認してください(以前の「適用マニュアルの変更」ステップ内で処理されていますが、それらをチェックするダブルチェックができます。 OrangeHRM ディレクトリ内の通知ファイル:

cat /var/www/orangehrm/upgrader/log/notes.log

「送信」ボタンをクリック。

アップグレードされたOrangeHRMデータを有効にします

前のステップの後、ログにページをリダイレクトします。 'admin'ユーザーとパスワードを使用してログインします。

最終「お祝い!」ページで記されたように: > [...]は、以前の > バージョンが適切にインポートされているかどうかを確認するために、データ検証の完全なラウンドを行います。

特に、これらのページが利用可能なことを確認し、データを含む: - 管理者 - PIM - 退去

OrangeHRM v4.10.1 を v5.7 にアップグレード

v5.7 へのアップグレードの手順は、以前のアップグレードと非常に似ています。 これらの手順は、後続の v5.x の更新にも適用されます。 ただし、OrangeHRM v5.xには、これらの指示がカバーするCLIインストーラ/アップグレードが含まれています。

アップグレードごとに、OrangeHRM は v4.10.1 のアップグレードで、 アップグレードのドキュメント しかし、WebUIのアップグレードのみをカバーしています。 これらの手順は、CLIツールを使用してTurnKey固有のノートを提供します。

準備方法

無料のスペースをダブルチェックし、初期のOrangeHRM v4アップグレードで新しいOSバックアップとスナップショットを作成します。

マニュアルデータベースローカルバックアップも作成します。

mysqldump orangehrm > orangehrm_v4.10.1_db.sql

v5.7をダウンロード

wget https://sourceforge.net/projects/orangehrm/files/stable/5.7/orangehrm-5.7.zip

既存のインストールの移動

mv /var/www/orangehrm /var/www/orangehrm-4.10.1

新規バージョンを解凍

unzip -o orangehrm-5.7.zip
mv orangehrm-5.7 /var/www/orangehrm

CLI によるアップグレードインストール

CLI のアップグレードは、IMO のより速く、より簡単です。

既存のデータベースパスワードを持っていることを確認してください。

grep -m 1 password /var/www/orangehrm.*/symfony/config/databases.yml

次に、新しいOrangeHRMディレクトリ(ダウンロードして解凍した)に変更し、CLIツールを実行します。 'を置き換える必要があります。' 実際の DB パスワード (上のコマンドから) で。 また、バージョンからアップグレードする場合は、 4.10.1 以外のバージョンでも、 “–currentVersion” の値を変更します。

cd /var/www/orangehrm
php installer/console upgrade:run \
    --dbHost=127.0.0.1 \
    --dbPort=3306 \
    --dbName=orangehrm \
    --dbUser=orangehrm \
    --dbUserPassword=<db password> \
    --currentVersion=4.10.1

環境を検証

上記のコマンドは、公正なテキストビットを出力します。 ほとんどのテキストは、安全に無視できますが、 「システムチェック」セクションを2回確認してください。 値はすべて緑色(または使用しない場合は黄色)でなければなりません。

システムチェックが赤くなれば、上記アップグレードコマンドを再実行する前に「n」に答えて解決する必要があります。

システムチェックが全てOKであると仮定すると、Enterキーを押します(デフォルトは「はい」)。

アップグレードはしばらくの間は少しかかるかもしれませんが、最終的にはエラーメッセージなしで完了して終了します。

アップグレードされたOrangeHRMデータを有効にします

アップグレードスクリプトが完了したら、Webブラウザでオレンジ色のHRMインスタンスにログインし、すべてのデータがそこにあり、それが必要なときにすべてが機能していることを検証します。

と仮定して、おめでとうございます。最新のOrangeHRMを実行しています! :)