====== アップデート ======
{{indexmenu_n>2}}
[[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
===== 概要 =====
There are two main ways to update Pandora FMS environment:
Pandora FMS 環境を更新するには、主に 2 つの方法があります。
* **Through Warp Update**.
* Manually.
* **ワープアップデートを通して**
* 手動
**Warp Update** is in charge of updating Pandora FMS Console, server and database automatically by means of wizards. It is the recommended option to update Pandora FMS.
**ワープアップデート** は、ウィザードを使用して Pandora FMS コンソール、サーバ、データベースを自動更新します。Pandora FMS のアップデートには、ワープアップデートの使用をお勧めします。
In case you need to update Pandora FMS manually, you may apply the updates manually, just by following a more detailed and demanding but equally valid procedure.
Pandora FMS を手動で更新する必要がある場合は、詳細な手順に従ってアップデートを手動で適用できます。
===== ワープアップデート =====
Updates through **Warp Update** may be applied by means of two different wizards:
**ワープアップデート** による更新は、次の 2 つの異なるウィザードを使用して適用できます。
* **Warp Update Online**: It is responsible for downloading and updating Pandora FMS server, console and database automatically. It requires internet connection to Pandora FMS repositories.
* **Warp Update Offline**: It is responsible for updating Pandora FMS server, console and database automatically. Pandora FMS Server and Console packages should be entered manually in the console wizard to carry out the update. This is the best option for updating in environments with restricted and/or limited connections with Pandora FMS repositories.
* **オンラインワープアップデート**: Pandora FMS サーバ、コンソール、データベースのダウンロードとアップデートを自動で実行します。Pandora FMS リポジトリへのインターネット接続が必要です。
* **オフラインワープアップデート**: Pandora FMS サーバ、コンソール、データベースのアップデートを自動で実行します。アップデートを実行するには、Pandora FMS サーバおよびコンソールのパッケージをコンソールウィザードに手動で入力する必要があります。これは、Pandora FMS リポジトリへの接続が制限されている環境でのアップデートに最適なオプションです。
This section will only be visible if **Enable Warp Update** is enabled in menu **Management → Settings → System Settings → Advanced → Enable update manager**.
このセクションは、メニュー **管理 → セットアップ → システム設定 → 詳細設定 → アップデートマネージャーの有効化** で **ワープアップデートを有効にする** が有効になっている場合にのみ表示されます。
==== オンラインワープアップデート ====
To use the **Warp Update Online,** access the **Management → Warp Update → Update Online** menu. For its operation, Pandora FMS Console must have access to the official Pandora FMS online repositories.
**オンラインワープアップデート** を使用するには、**管理 → ワープアップデート → オンラインアップデート** メニューにアクセスします。この機能を使用するには、Pandora FMS コンソールが公式 Pandora FMS オンラインリポジトリにアクセスできる必要があります。
To update through **Warp Update Online,** sign up with an e-mail address.
**オンラインワープアップデート** からアップデートするには、電子メールアドレスでサインアップしてください。
{{ :wiki:pfms-update-image_010.png }}
Once these previous requirements are met, it will show the current Pandora FMS version installed and the new versions to which it is possible to upgrade:
これらの要件が満たされると、現在インストールされている Pandora FMS のバージョンと、アップグレード可能な新しいバージョンが表示されます。
{{ :wiki:pfms-update-image_020.png }}
The release notes for each version available for upgrade will also be available through the **Show details**.
アップグレード可能な各バージョンのリリースノートも、**詳細表示(Show details)** から入手できます。
Only LTS versions and/or consecutive versions will be displayed depending on [[#ks2_4|Warp configuration]].
[[#ks2_4|ワープ設定]] に応じて、LTS バージョンまたは連続バージョンのみが表示されます。
Once the version to be upgraded is selected, the wizard will start downloading and [[#ks3_4|installing automatically]].
アップグレードするバージョンを選択すると、ウィザードがダウンロードを開始し、[[#ks3_4|自動的に]] インストールされます。
==== オフラインワープアップデート ====
To use **Warp Offline**, access the **Management → Warp Update → Update Offline** menu. The **Warp Offline** does not require internet connection to perform updates. //The administrator must manually download the packages and upload them to the wizard to perform the update//.
**オフラインワープアップデート** を使用するには、**管理 → ワープアップデート → オフラインアップデート** メニューにアクセスしてください。**オフラインワープアップデート** では、アップデートを実行するためにインターネット接続は必要ありません。//管理者は手動でパッケージをダウンロードし、ウィザードにアップロードしてアップデートを実行する必要があります//。
When accessing this section, you will be prompted to enter an e-mail address and a unique access code related to the applied license will be displayed. It must be copied by clicking on the {{:wiki:icon_copy.png?nolink&21x21}}icon. The indicated link is accessed to open in a new tab of the web browser and enter the repository, pasting the code will log in to download the necessary files.
このセクションにアクセスすると、メールアドレスの入力を求められます。すると、適用されたライセンスに関連付けられた固有のアクセスコードが表示されます。このコードは{{:wiki:icon_copy.png?nolink&21x21}}アイコンをクリックしてコピーする必要があります。表示されたリンクにアクセスすると、Webブラウザの新しいタブが開き、リポジトリにアクセスできます。コードを貼り付けるとログインでき、必要なファイルをダウンロードできます。
{{ :wiki:pfms-update-image_030.png }}
After logging in, it will indicate which Pandora FMS version is installed, which is the next available version and the last available version.
ログイン後、インストールされている Pandora FMS のバージョン、次に利用可能なバージョン、利用可能な最新バージョンが表示されます。
{{ :wiki:pfms-update-image_040.png }}
When you select the desired version, a dialog box will open to download the files needed to perform the upgrade.
希望するバージョンを選択すると、アップグレードを実行するために必要なファイルをダウンロードするためのダイアログボックスが開きます。
* **File**''package_XXX_XXX.fms'': It is responsible for updating the console and the database schema.
* **File**''pandorafms_server-XXXXX.tar.gz'': It is responsible for updating the server.
* **File**''.sig'': Signature of the above files used to corroborate that the package has not been modified.
* **ファイル**''package_XXX_XXX.fms'': コンソールとデータベーススキーマの更新を担当します。
* **ファイル**''pandorafms_server-XXXXX.tar.gz'': サーバの更新を担当します。
* **ファイル**''.sig'': パッケージが変更されていないことを確認するために使用される上記ファイルの署名。
Once the files have been downloaded, access the **Warp Update Offline** menu again and click **Browse it** to select file by file. Review the information displayed on the screen to see if it matches the updates and/or corrections. To process, click on the green icon in the lower right corner and wait for the Web Console to display the results of each process.
ファイルのダウンロードが完了したら、**オフラインワープアップデート** メニューに再度アクセスし、**参照(Browse it)** をクリックしてファイルを 1つずつ選択します。画面に表示される情報を確認し、更新内容や修正内容と一致しているかどうかを確認します。処理を実行するには、右下隅の緑色のアイコンをクリックし、Web コンソールに各処理の結果が表示されるまで待ちます。
The size of each file must be smaller than specified in the token ''post_max_size'' and ''upload_max_filesize'' in the ''/etc/php.ini'' file.
各ファイルのサイズは、''/etc/php.ini'' ファイルのトークン ''post_max_size'' および ''upload_max_filesize'' で指定されたサイズよりも小さくする必要があります。
It is recommended to update first the Console and Pandora FMS database schema and then the server. To finish off, [[#ks3_4|check the update]].
まずコンソールと Pandora FMS データベーススキーマを更新し、次にサーバを更新することをお勧めします。最後に[[#ks3_4|更新を確認]]します。
==== ワープアップデート履歴 ====
To access the **Warp Update Journal**, access the **Management → Warp Update → Warp journal** menu.
**ワープアップデート履歴** にアクセスするには、**管理(Management) → ワープアップデート(Warp Update) → ワープ履歴(Warp journal)** メニューにアクセスします。
It will display a log of updates performed by **Warp Update** where it indicates:
**ワープアップデート** によって実行された更新のログが表示され、次の内容が示されます。
* The updated version.
* The type of update (server or Console).
* The source (online or offline).
* The user who carried out the update.
* The update timestamp.
* 更新バージョン
* 更新の種類（サーバーまたはコンソール）
* ソース（オンラインまたはオフライン）
* 更新を実行したユーザ
* 更新のタイムスタンプ
==== ワープセットアップ (オプション) ====
To access the **Warp Setup**, access the **Management → Warp Update → Options** menu.
**ワープセットアップ(Warp Setup)** にアクセスするには、**管理(Management) → ワープアップデート(Warp Update) → オプション(Options)** メニューにアクセスします。
Different configurations are available for **Warp Update**:
**ワープアップデート** にはさまざまな設定が用意されています。
* **Allow no-consecutive patches**: It allows installing non-consecutive version upgrades. It is disabled by default and it is the recommended option.
* **Limit to LTS updates**: It allows upgrading only to LTS (**Long Term Support**) versions, which are more reliable versions with extended support.
* **非連続パッチを許可(Allow no-consecutive patches)**: 非連続バージョンアップグレードのインストールを許可します。デフォルトでは無効になっており、推奨オプションです。
* **LTSアップデートに限定(Limit to LTS updates)**: より信頼性の高い、拡張サポート付きバージョンであるLTS (**長期サポート**) バージョンへのアップグレードのみを許可します。
It is recommended to contact the support department before changing any of the following fields:
以下のフィールドを変更する場合は、サポートに問い合わせることをお勧めします。
* **Warp Update URL**.
* **Use secured Warp Update**.
* **Proxy server**.
* **Proxy port**.
* **Proxy user**.
* **Proxy password**.
* **ワープアップデート URL(Warp Update URL)**
* **セキュアなワープアップデートの利用(Use secured Warp Update)**
* **プロキシサーバ(Proxy server)**
* **プロキシポート(Proxy port)**
* **プロキシユーザ(Proxy user)**
* **プロキシパスワード(Proxy password)**
===== 手動アップデート =====
If you choose to update Pandora FMS without **Warp Update**, you will have to perform a manual update for each system component. This approach allows to supervise each step of the process, executing the necessary steps individually. It is a process that requires full attention and control by the user.
**ワープアップデート** を使用せずに Pandora FMS をアップデートする場合は、各システムコンポーネントを手動でアップデートする必要があります。この方法では、プロセスの必要な各ステップを確認し個別に実行できます。この処理にはユーザに十分な注意が要求されます。
When updating Pandora FMS manually, it is important to take into account the correct order to update Pandora FMS:
Pandora FMS を手動でアップデートする場合は、Pandora FMS をアップデートする正しい順序を考慮することが重要です。
* Web console.
* Database schema.
* Server.
* Web コンソール
* データベーススキーマ
* サーバ
To carry out the update of these components, you must have the ''.tar.gz'' package from the server and ''.fms'' from the Console, of the desired Pandora FMS version to update to.
これらのコンポーネントの更新を実行するには、更新する Pandora FMS バージョンの ''.tar.gz'' パッケージをサーバから、また ''.fms'' をコンソールから取得する必要があります。
To download these packages, see [[#ks2_2|Warp Update Offline]], where it is explained how to download them.
これらのパッケージをダウンロードするには、[[#ks2_2|オフラインワープアップデート]] を参照してください。ダウンロード方法が説明されています。
It is strongly recommended to take a snapshot or [[:en:documentation:pandorafms:technical_annexes:07_backup_and_restore_procedures|backup]] of the whole Pandora FMS machine, or otherwise a backup copy of all PFMS components before carrying out any intervention, so that in case of failure, the application may be restored in a simple way.
何らかの操作を行う前に、Pandora FMS マシン全体のスナップショットまたは [[:ja:documentation:pandorafms:technical_annexes:07_backup_and_restore_procedures|バックアップ]]、あるいはすべての PFMS コンポーネントのバックアップコピーを作成することを強くお勧めします。こうすることで、障害が発生した場合にアプリケーションを簡単に復元できるようになります。
To perform the full Pandora FMS update, you need to connect to Pandora FMS server terminal by means of the **root** user. This procedure is supported by EL 7, EL 8, EL 9 and Ubuntu 22.04 LTS systems.
Pandora FMS の完全アップデートを実行するには、**root** ユーザで Pandora FMS サーバターミナルに接続する必要があります。この手順は、EL 7、EL 8、EL 9、および Ubuntu 22.04 LTS システムでサポートされています。
==== コンソールアップデート ====
Move file ''package_XXX.XXX.XXX.fms'' to the Console path:
ファイル ''package_XXX.XXX.XXX.fms'' をコンソールパスに移動します。
mv package_XXX.XXX.fms /var/www/html/pandora_console/
Unzip file ''package_XXX.XXX.fms'':
''package_XXX.XXX.fms'' を展開します:
unzip package_XXX.XXX.fms
When running it, you will be asked which action to perform for the files to be replaced. In this case, select ''A'':
実行すると、置換するファイルに対して実行するアクションを選択するよう求められます。この場合は ''A'' を選択してください。
replace .gitignore? [y]es, [n]o, [A]ll, [N]one, [r]ename: A
Update the Console version in the database, replacing ''XXX'' by the Pandora FMS version to which it has been updated:
データベース内のコンソールのバージョンを更新し、''XXX'' を更新後の Pandora FMS バージョンに置き換えます。
mysql -u root -p -D pandora -e "UPDATE tconfig SET value=XXX WHERE token='current_package'"
==== データベーススキーマアップデート ====
To update Pandora FMS database schema, the script to update the MR must be manually executed:
Pandora FMS データベーススキーマを更新するには、MR を更新するスクリプトを手動で実行する必要があります。
/usr/bin/php /var/www/html/pandora_console/godmode/um_client/updateMR.php
==== サーバアップデート ====
Decompress the ''tar.gz'' of Pandora FMS server ''pandorafms_server-XXXXX.tar.gz'':
Pandora FMS サーバ ''pandorafms_server-XXXXX.tar.gz'' の ''tar.gz'' を展開します。
tar -xzvf pandorafms_server-XXXXX.tar.gz
Access the unzipped folder:
展開したフォルダにアクセスします。
cd pandora_server/
Execute the installer:
インストーラを実行します。
./pandora_server_installer --install
Restart Pandora FMS server:
Pandora FMS サーバを再起動します。
systemctl restart pandora_server
==== アップデートの確認 ====
Access the **Management → About** section from Pandora FMS console. There you will be able to correctly see the console version in **Information → Current Package** and that of the database schema in MR:
Pandora FMS コンソールから **管理(Management) → 情報(About)** セクションにアクセスします。**情報(Information) → 現在のパッケージ(Current Package)** でコンソールのバージョンが正しく表示され、MR ではデータベーススキーマのバージョンが正しく表示されます。
{{ :wiki:pfms-update-image_050.png }}
Access the **Management → Servers → Manage Server** section from Pandora FMS console. See the correct server version in the **Version** column of all servers.
Pandora FMS コンソールから **管理(Management) → サーバ(Servers) → サーバ管理(Manage Server)** セクションにアクセスします。すべてのサーバの **バージョン(Version)** 列で正しいサーババージョンを確認します。
{{ :wiki:pfms-update-image_060.png }}
[[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
===== (OBSOLETE) =====
==== マイナーバージョンアップ ====
1. [[:es:documentation:07_technical_annexes:07_backup_and_restore_procedures|Back up]] the database. E.g.:
1. データベースを[[:ja:documentation:07_technical_annexes:07_backup_and_restore_procedures|バックアップ]]します。例:
mysqldump -u root -p pandora > backup_pfms_X.Y.sql
2. Back up the config files: ''pandora_server.conf'', ''config.php'' and ''pandora_agent.conf''.
2. 次の設定ファイルをバックアップします: ''pandora_server.conf'', ''config.php'', ''pandora_agent.conf''
3. Back up server and agent plugins, at:
3. サーバおよびエージェントプラグインを次のようにバックアップします。
/etc/pandora/plugins
pandora_console/attachment/plugin
/usr/share/pandora_server/util/plugin
4. Stop the following services: ''pandora_server'', ''tentacle_serverd'', ''httpd'', ''pandora_agent'' and ''mysqld''.
4. 次のサービスを停止します: ''pandora_server'', ''tentacle_serverd'', ''httpd'', ''pandora_agent'' および ''mysqld''
5. **Proceed to update.**
5. アップデートします。
6. Remember to restart the services: ''pandora_server'', ''tentacle_serverd'', ''httpd'', ''pandora_agent'' and ''mysqld''.
6. 次のサービスを再起動します: ''pandora_server'', ''tentacle_serverd'', ''httpd'', ''pandora_agent'' および ''mysqld''
=== RPM パッケージにて ===
* Update of the Console web:
* コンソールアップデート:
rpm -U pandorafms_console_enterprise_package.rpm
* PFMS server update with tar.gz:
* tar.gz での PFMS サーバアップデート:
tar -xvzf pandorafms_server_enterprise_package.tar.gz
cd pandora_server
./pandora_server_installer --install
* Software Agent Update:
* ソフトウエアエージェントアップデート:\
rpm -U pandorafms_agent_*.rpm
At all times, before and after the update, you will be able to know your installed versions by running the command:
インストール前後で、どのバージョンで動いているか、以下のコマンドで確認できます。
rpm -qa | grep -i pandora
=== tar ボール、ソースにて ===
* Change ''package'' to the name of the downloaded version and ''yourconsolepath'' to the full path of the installed console.
* Update of the Console web:
* ''package'' をダウンロードしたバージョンの名前に変更し、''yourconsolepath'' をコンソールをインストールしたフルパスにします。
* コンソールのアップデート:
tar xvzf pandorafms_console_enterprise_'package'.tar.gz
cd pandora_console
./pandora_console_upgrade -p /'yourconsolepath'
* PFMS Server update:
* PFMS サーバアップデート:
tar xvzf pandorafms_server_enterprise_'package'.tar.gz
cd pandora_server
./pandora_server_installer --upgrade
* Software Agent Update:
* ソフトウエアエージェントアップデート:
tar xvzf pandorafms_agent_'package'.tar.gz
cd pandora_agent
./pandora_agent_installer --force-install
==== メジャーアップデート ====
It is always recommended to update the Console using **Warp Update**. If the database is out of date, the web console will show a notice with the title **Minor release/s available.**
通常は、**ワープアップデート**を使用してコンソールを更新することをお勧めします。 データベースが古い場合、ウェブコンソールに **マイナーリリースが利用可能** というタイトルの通知が表示されます。
To solve this problem, enter the server where the Pandora FMS console is installed and go to the directory:
この問題を解決するには、Pandora FMS コンソールがインストールされているサーバに入り、次のディレクトリに移動します。
/var/www/html/pandora_console/extras/mr
Within this directory another one will appear called ''updated''. It must stock all non-applied MR and outside it those who are not applied. Execution example of file ''1.sql'' (MR 1):
このディレクトリ内に、''updated'' という名前の別のディレクトリがあります。そのディレクトリの外に適用されていないすべての MR があるので適用します。ファイル ''1.sql'' (MR 1) の実行例:
cat 1.sql | mysql -u root -p pandora
Once the **SQLs** have been applied to the database, go to the directory called ''updated''.
データベースに **SQL** を適用したら、適用したファイルを ''updated'' ディレクトリに移します。
mkdir -p updated
mv 1.sql updated/
Then update the **MR** value within the ''tconfig'' table of MySQL:
そして、MySQL の ''tconfig'' テーブルにある **MR** の値を更新します。
mysql -u root -p pandora> use pandora;> update tconfig set value= XX where token='MR';
To find out which MRs should be applied, please go to the following [[:en:documentation:08_technical_reference:10_versions|link.]]
どの MR が適用されている必要があるかは、[[:ja:documentation:08_technical_reference:10_versions|こちら]]を確認してください。
===== ダウングレード =====
==== RPM パッケージより ====
* Console web update:
* ウェブコンソールのアップデート:
rpm -i --force pandorafms_console__enterprise_package.rpm
==== Tarball/ソースコードより ====
* Console web update:
* ウェブコンソールのアップデート:
tar -xvzf pandorafms_console_package.tar.gz
mv --force ./enterprise /yourconsolepath
[[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
===== OBSOLETE =====
=== データベースのアップデート ("メジャーリリース") ===
データベースをアップデートするには、最初にバージョンに応じたオープンソースおよび Enterprise コンソールをアップデートする必要があります。これらのアップデートによって必要な SQL ファイルをダウンロードできます。
コンソールをアップデートしたら、SQL のデータベースアップデートスクリプトがコンソールの /extras や /enterprise に見つかります(バージョンに依存します)。CentOS の場合であれば、以下にあります。
/var/www/html/pandora_console/extras/pandoradb_migrate_X.Y_to_Z.T.mysql.sql
/var/www/html/pandora_console/enterprise/pandoradb_migrate_vX.Y_to_vZ.T.mysql.sql
アップデートの前に最初に説明した、データベース、設定ファイルのバックアップ、Pandora FMS サーバの停止といった準備を行います。
service pandora_server stop
* オープンソースデータベースのアップデート:
mysql -u ユーザ名 -p -D データベース名
例:
mysql -u pandora -p -D pandora
MySQL コマンドラインで以下を実行します。
source /yourconsolepath/extras/pandoradb_migrate_X.Y_to_Z.T.mysql.sql;
オープンソース版のマイグレーションを実行すると、Enterprise 版もアップデートされます。
MySQL から抜けるには "quit" を実行します。以上でデータベースがバージョンに合わせてアップデートされました。
以前のバージョンに戻す必要がある場合は、以下のようにバックアップからリストアします。
mysql -u username -p databasename
> drop database databasename;
> create database newdatabasename;
> use newdatabasename;
> source backup_pfms_X.Y.sql
mysql -u ユーザ名 -p データベース名
> drop database データベース名;
> create database 新たなデータベース名;
> use 新たなデータベース名;
> source backup_pfms_X.Y.sql
例:
mysql -u root -p pandora
> drop database pandora;
> create database pandora;
> use pandora;
> source backup_pfms_X.Y.sql;
==== オープンソース版の更新 ====
Pandora FMS 4.0.2 から、オープンソース版でも週単位の半自動更新ができます。この機能は、以前はエンタープライズ版のみにあったアップデートマネージャシステムの改善によります。新たなアップデートがあるかどうかを**オンライン** で確認することができ、リクエストごとにコンソールを自動的にダウンロードして更新することができます。
この機能は次のような仕組みです。
* Pandora FMS コンソールがインストールされているサーバはインターネットに接続されていなければなりません。
* アップデートマネージャは、我々のサーバ(Sourceforge)に接続します。Pandora FMS の利用状況(エージェント数)を発信者を特定しない状態で送信します。
* 更新ファイルが Sourceforge から週単位で更新フォルダにダウンロードされます。
* 更新はインクリメンタルですが、コンソール全体のファイルを含みます。そのため、処理には時間がかかります。(パッケージは約 25MB あります)
* 更新は自動です。開発チームによるレビューはされていません。99%は問題無いと思いますが、何も問題が無いことを保証するわけではありません。
* 更新は、**コンソールのみ** です。エージェントおよびサーバの更新はありません。
=== コンソールの更新手順 ===
**アップデートマネージャ(Update Manager)** → **オンラインアップデートマネージャ(Update manager online)** へ行きます。メインの画面では、インストール待ちおよび存在するアップデート、最新のコンソールバージョンが表示されます。インストールをクリックします。
{{ :wiki:um_online_open_actualizar_es.png }}
パッケージをダウンロードすると、アップデートを行うかどうかのオプションが表示されます。
{{ :wiki:dialog_um_principal_es.png }}
インストール処理を開始するには確認をクリックします。
いくつかのアップデートにはデータベースの修正も含みます。アップデート処理では、これらの変更に関する情報を次のようにダイアログ表示します。
{{ :wiki:dialog_hay_mr_en.png }}
この時点で、データベースとコンソールのアップデートを適用するか、それを実施せずにコンソールとデータベースを現状のままとするかの 2つの選択肢があります。
アップデートマネージャが動作するためにはインターネットへの接続が必要です。パッケージのダウンロードに、デフォルトでは wget を利用します。curl を利用することもできます(Pandora の設定で変更します)がさほど早くありません。
処理が終わると、メインのアップデートページにコンソールのバージョンが表示されます。 おめでとうございます、これが表示されればアップデート成功です。
{{ :wiki:um_online_open_finalizado.png }}
=== 設定 ===
{{:wiki:icono-modulo-enterprise.png |Enterprise 版}}
Enterprise 版のアップデートマネージャを利用できるようにするには、最初にアップデータを正しく設定する必要があります。該当メニューから設定を行います。
{{ :wiki:opciones_um_es.png?700 }}
=== "オンライン" 更新 ===
アップデートのメニューから、アップデートマネージャへアクセスします。Enterprise 版をインストールしている場合は、インタフェースを利用可能です。(そうでなければオープンソース版が表示されます)
このページで現在利用している Pandora FMS のバージョンと新たなアップデートがあるか確認することができます。
最新バージョンにアップデートするには、Pandora FMS コンソールのリンクをクリックします。
継続するかどうかのオプションダイアログが表示されます。
{{ :wiki:dialog_um_principal_es.png?500 }}
継続をクリックすると、1) コンソールをアップデートして終了するか、2) データベースを含めて更新するかを確認するダイアログが表示されます。
データベースを更新するとプロセスは正常に実行されます。 ただし、そうでない場合、データベースまたはコンソールのいずれも更新されません。データベースの変更によっては、同じ更新プログラムでのコンソールの変更に重大な影響を及ぼす可能性があるためです。
その後、Pandora FMS にインストールされた現在のバージョンのアップデータが表示されます。
=== "オフライン" 更新 ===
{{:wiki:icono-modulo-enterprise.png?23x23 |Enterprise version}}Offline Pandora FMS updates can also be downloaded, which have ''.OUM'' extensions. Go to the official Pandora FMS support page to download them.
{{:wiki:icono-modulo-enterprise.png?23x23 |Enterprise 版}}Pandora FMS は "オフライン" アップデートも可能です。 .OUM という拡張子のパッケージがあります。それには、Pandora FMS の公式サポートページへ行き、.OUM ファイルをダウンロードしてください。日本におけるエンタープライズ版更新ファイルダウンロードは、[[https://www.rworks.jp|(株)アールワークス]] が提供しています。
次の画面からそれをアップロードします。
{{ :wiki:um_offline_pag_principal_es.png }}
アップロードが完了するとファイルが表示されます。アップデートには開始をクリックします。
{{ :wiki:um_offline_pag_principal_cargado_es.png }}
アップデートは、オンラインのダウンロードと同じフローです。適用する変更がある場合、関連するコンソールおよびデータベースのアップデートダイアログが表示されます。
我々のチームが提供している zip ファイルを使っても、同じ方法で Pandora コンソールをアップデートできます。
HA 構成のシステムをアップデートする場合は、[[:ja:documentation:05_big_environments:06_ha|こちらのドキュメント]] を参照してください。
==== 他のシステムへのマイグレーション ====
There can be many reasons to move a PFMS server and its Web Console, which are usually on the same machine, real or virtual.
同一の物理マシンや仮想マシン上にある、Pandora FMS サーバとその Web コンソールを移動する理由はたくさんあります。
//**Possible examples:** //
//**考えられる例:** //
* A new version of Pandora FMS may require a different operating system, for example, migrating from CentOS 7 to Rocky Linux 8 or from CentOS 8 to RedHat Enterprise (RHEL) 8.
* It could also be the case of moving from one web service provider to another: less data is used by Pandora FMS than to make an image of the entire operating system.
* In case of audits or to test new functionalities, it is necessary to have a copy of the main server.
* Pandora FMS の新しいバージョンでは、別のオペレーティングシステムが必要になる場合があります。たとえば、CentOS 7 から RockyLinux 8 に、またはCentOS 8 から RedHat Enterprise(RHEL) 8 への移行です。
* また、ある Web サービスプロバイダーから別のプロバイダーに移動する場合もあります。Pandora FMS で使用されるデータは、オペレーティングシステム全体のイメージを作成する場合よりも少なくなります。
* 監査の場合や、新しい機能をテストする場合は、メインサーバのコピーが必要です。
**Procedure:**
**手順:**
Note: Generally the full path to the PFMS Web Console is ''/var/www/html/pandora_console'' and in the following instructions it is abbreviated as ''$CONSOLE_PATH'' .
注意: 通常、Pandora FMS Web コンソールへのフルパスは ''/var/www/html/pandora_console'' であり、以下の手順では ''$CONSOLE_PATH'' と省略しています。
**1.-** Make a backup of the database of the previous system. There are several steps, open a terminal window with administrator rights ( //root// user):
**1.-** 以前のシステムのデータベースバックアップを行います。いくつかの手順があります。管理者権限( //root// ユーザ)でターミナルウィンドウを開きます。
* Start by making a logical copy of the database with the following command:
* 次のコマンドを使用して、データベースの論理コピーを作成することから始めます。
mysqldump --single-transaction --max_allowed_packet=512M -u root -p pandora> backup_pandora_X.Y.sql
* The resulting file ( ''backup_pandora_X.Y.sql'' ) will be compressed with the following data in order to have a single file for the move. For example ''backup_pandora_X.Y.tar.gz'' , compressed format which preserves the intrinsic values of each file.
* Compress all existing configuration files in the directory ''/etc/pandora/*.conf'' .
* Compress the entire directory and subdirectories of ''$CONSOLE_PATH/attachment/'' .
* Custom images and icons in ''$CONSOLE_PATH/images/'' , if any exist.
* Compress the whole directory ''/var/spool/pandora/data_in/'' .
* Compress all [[:en:documentation:08_technical_reference:05_anexo_server_plugins_development|server plugins]] located in ''/usr/share/pandora_server/util/plugin/'' . If you have some server plugin(s) located in another directory that is not indicated you should also compress them.
* Compress all dependencies installed on the source server, which are necessary for the correct operation of scripts / plugins installed on the source server and are not found on the target server. **Advanced systems will need to fully install the Integrated Development Environment** (**IDE**).
* Compress all SSL certificates and custom Apache web server configuration located in ''/etc/httpd/'', if any such file(s) exist.
* 出力ファイル (''backup_pandora_X.Y.sql'') は、移動用の単一のデータファイルとして圧縮します。たとえば、''backup_pandora_X.Y.tar.gz'' は、各ファイルの固有の値を保持する圧縮形式です。
* ディレクトリ ''/etc/pandora/*.conf'' にある既存のすべての設定ファイルを圧縮します。
* ''$CONSOLE_PATH/attachment/'' のディレクトリ全体(サブディレクトリ含む)を圧縮します。
* ''/var/spool/pandora/data_in/'' ディレクトリ全体を圧縮します。
* ''/usr/share/pandora_server/util/plugin/'' にあるすべての [[:ja:documentation:08_technical_reference:05_anexo_server_plugins_development|サーバプラグイン]] を圧縮します。ここ以外の別のディレクトリにサーバープラグインがある場合は、それらも圧縮する必要があります。
* 元サーバにインストールされているすべての依存関係を圧縮します。これらは、元サーバにインストールされていたスクリプト/プラグインが正しく操作するために必要であり、移行先サーバにはありません。 **高度なシステムでは、統合開発環境(**IDE**)を完全にインストールする必要があります。**
* 存在する場合は、''/etc/httpd/'' にあるすべての SSL 証明書とカスタム Apache Web サーバ設定を圧縮します。
\\ You are the only person responsible for safeguarding your data. Write down on pen and paper the procedure you will choose for moving data. **Be careful**, use redundancy in backups and procedures with several people to assist you in the process. \\
\\ データの保護は作業するあなたにかかっています。 データを移動するために行う手順は書き留めておきましょう。 処理を行う際は複数人で手順やバックアップを確認するなど、十分**注意**してください。\\
**2.-** Install the new Pandora FMS system from scratch, the [[:en:documentation:02_installation:01_installing#online_installation_tool|online installation tool]] is recommended.
**2.-** 新たな Pandora FMS システムをスクラッチからインストールします。[[:ja:documentation:02_installation:01_installing#オンラインインストールツール|オンラインインストールツール]]がお勧めです。
**3.-** Close all the processes running in the new system, except **mysql**; start with Pandora FMS (from version NG 754 onwards you have [[:en:documentation:05_big_environments:07_server_management#manual_startupshutdown_for_pandora_fms_servers|additional options]] in the manual start and stop of HA High Availability Environments):
**3.-** **mysql** を除いて新しいシステムで実行されているすべてのプロセス終了し、Pandora FMS を開始します(バージョン NG 754 以降では、HA 高可用性環境での手動での開始・停止の[[:ja:documentation:05_big_environments:07_server_management#pandora_fms_サーバの手動起動停止|追加オプション]] があります)。
/etc/init.d/pandora_server stop
/etc/init.d/pandora_agent_daemon stop
/etc/init.d/tentacle_serverd stop
**4.-** To stop the Apache server will depend on the distribution you are using:
**4.-** Apache サーバを停止するには、使用しているディストリビューションに合わせて以下のいずれかを実行します。
/etc/init.d/apache2 stop
/etc/init.d/httpd stop
systemctl stop httpd.service
**5.-** Then send or copy, in the easiest way, the ''backup_pandora_X.Y.tar.gz'' file from the old system to the new one. Unzip the files in their corresponding places.
**5.-** 次に、一番簡単な方法で、''backup_pandora_X.Y.tar.gz'' ファイルを古いシステムから新しいシステムに送信またはコピーします。 対応する場所でファイルを展開します。
**6.-** Enter **mysql** with //root// user. Access the Pandora FMS database in the new system, by default ''pandora'' and import the database.
**6.-** //root// ユーザ **mysql** にアクセスします。新しいシステムで Pandora FMS データベースにアクセスします。デフォルトでは ''pandora'' です。そして、データベースをインポートします。
# mysql -u root -p
mysql>use pandora
Database changed
mysql>source ~/backup_pandora_X.Y.sql
//This path will vary depending on the directory where you have the backup of the previous system, //here it is assumed that you have it in your home directory (''$HOME'').
//このパスは、以前のシステムのバックアップを取得したディレクトリに依存します。// ここでは、(''$HOME'') にあると仮定します。
**7.-** In the case of a migration to a major version, where the database structure changes, this would be the time to run the migration scripts as indicated in the [[:en:documentation:02_installation:02_anexo_upgrade#major_release_update|major version upgrade procedure]].
**7.-** データベース構造が変更されるメジャーバージョンへの移行の場合、[[:ja:documentation:02_installation:02_anexo_upgrade#メジャーバージョンアップ|メジャーバージョンのアップグレード手順]] に示されているように移行スクリプトを実行するタイミングです。
**8.- **If you have made a distribution change, please note that the ''PATH'' of the Web Console has been modified and in that case there are some fields in the database that have also been modified, such as the ''tconfig ''table and its ''attachment_store'' and ''fontpath'' fields. To modify these fields you must enter these queries. The example is for a migration to Rocky Linux 8; in other distributions change the Apache directory ''path''.
**8.- ** ディストリビューションを変更した場合は、Web コンソールの ''PATH'' が変更される場合があることに注意してください。その場合、''tconfig'' テーブル、''attachment_store''、''fontpath'' など、データベースにも変更されたフィールドがいくつかあります。 これらのフィールドを変更するには、以下のクエリを入力する必要があります。 この例は、Rocky Linux 8 への移行です。 他のディストリビューションでは、Apache ディレクトリの ''path'' を変更します。
# mysql -u root -p> use pandora;
Database changed> UPDATE tconfig SET value = '/var/www/html/pandora_console/attachment' WHERE token LIKE 'attachment_store';> UPDATE tconfig SET value = '/var/www/html/pandora_console/include/fonts/smallfont.ttf' WHERE token LIKE 'fontpath';
//These //''PATH'' //s must also be taken into account in server and console configuration files// ( ''config.php'' y ''pandora_server.conf'' ).
これら ''PATH'' は、サーバとコンソールの設定ファイル(''config.php'' および ''pandora_server.conf'')に関係することを認識しておいてください。
**9.-** Once the database has been migrated, they should check whether the files ''…/pandora_console/include/config.php'' and ''/etc/pandora/pandora_server.conf'' and the new ones have the same data in the fields ''dbname'', ''dbuser'' y ''dbpass''.
**9.-** データベースをマイグレートしたら、設定ファイル ''…/pandora_console/include/config.php'' および ''/etc/pandora/pandora_server.conf'' の ''dbname'', ''dbuser'', ''dbpass'' フィールドが同じであることを確認します。
* //If they are the same, go to //**step 10**//.//
* If different, choose only one of the following options:
* Option ( a ): Replace the new files with the old ones.
* Option ( b ): Copy data ( ''dbname'', ''dbuser'' and ''dbpass'' ) of the old files into the new ones.
* Option ( c ): Give permissions to the database with the data of the new installation. Assuming that the new installation has these data: ''dbname=pandora'', ''dbuser=pandora1'' and ''dbpass=pandora2'', the example takes this form:
* //同じであれば、**ステップ10 **へ進みます。//
* 異なるようであれば、以下のオプションのうちのいずれか一つを選択します。
* オプション(a): 新しいファイルを古いものへ置き換え。
* オプション(b): 古いファイルの設定( ''dbname'', ''dbuser'' および ''dbpass'' )を新しいファイルに反映。
* オプション(c): 新規インストール用のデータを使用してデータベースへのアクセス許可を付与。 新規インストールでは ''dbname=pandora'', ''dbuser=pandora1'', ''dbpass=pandora2'' を使うことを想定した場合の例は次の通りです。
# mysql -u root -p> grant all privileges on pandora.* to 'pandora1'@'localhost' identified by 'pandora2';> flush privileges;
**10.-** After this, start all the [[:en:documentation:01_understanding:03_glossary#pandora_fms_glossary_of_terms|daemons]] again and you will be able to access the Pandora FMS Console, with all the Agents, Modules, alerts, etc.
**10.-** その後、すべての[[:ja:documentation:01_understanding:03_glossary#pandora_fms_glossary_of_terms|デーモン]]を再開し、すべての設定が完了しすべてのエージェント、モジュール、アラートなどを含んだ Pandora コンソールにアクセスできるようになります。
**11.-** If you have changed the IP address or URL on the new host, all **local** Agents will report to this new system. For the Software Agents you will have to modify the [[:en:documentation:02_installation:05_configuration_agents#server_ip|server_ip]] parameter in each of them.
**11.-** 新しいホストの IP アドレスまたは URL を変更した場合、すべての**ローカル**エージェントがこの新しいシステムに接続する必要があります。ソフトウェアエージェントの場合、それぞれの [[:ja:documentation:02_installation:05_configuration_agents#server_ip|server_ip]] パラメーターを変更する必要があります。
**12.-** Use, in [[:en:documentation:05_big_environments:01_massive_operations#massive_operationsagents|Bulk Operations, agent editing]] to finalize any pending details.
**12.-** その他の設定修正を行うには、[[:ja:documentation:05_big_environments:01_massive_operations#エージェント一括編集|一括操作のエージェント編集]] を利用します。
\\ If it is the Enterprise version, follow the same procedure. \\
\\ この手順は、Enterprise 版であっても同様です。
===== (OBSOLETE) アップデートマネージャを使った自動アップデート =====
* You must have [[:en:documentation:07_technical_annexes:15_security_architecture#keep_your_system_up-to-date|Internet access]] in Web Console and in Pandora FMS server.
* The **Update manager** menu is accessed → **Update manager online**.
* It will show if there is any pending update as well as the current version of the console.
* If there is any update, press **Ok** to install.
* Some of the updates carry database modifications. If this is the case, click on the **Apply MR** button.
* Click on the **Ok** button to finish the update process.
* Webコンソールと Pandora FMS サーバが [[:ja:documentation:07_technical_annexes:15_security_architecture#システムを最新の状態に保つ|インターネットアクセス]] できる必要があります。
* **アップデートマネージャ(Update manager)** メニュー → **アップデートマネージャオンライン(Update manager online)**
* 保留中のアップデートがあるかどうかと、コンソールの現在のバージョンが表示されます。
* 更新がある場合は、**Ok** を押してインストールします。
* 一部の更新にはデータベースの変更が含まれます。 この場合は、**MR を適用(apply MR)** ボタンをクリックします。
* **OK** ボタンをクリックして更新処理を終了します。
==== オフラインアップデート ====
You can download Pandora FMS offline updates, which are files with the extension ''.OUM''. To do this, go to the page of [[http://pandorafms.com/en/contact/|official support]] of Pandora FMS and download it.
拡張子 ''.OUM'' の Pandora FMS オフラインアップデートファイルをダウンロードできます。ダウンロードは、Pandora FMS の公式サポートページから行います。不明な場合は、[[https://pandorafms.com/ja/contact/|お問い合せ]]ください。
Offline patching can make your console unusable, it is recommended to do a [[:en:documentation:07_technical_annexes:07_backup_and_restore_procedures|full backup]] first.
オフラインパッチを適用すると、コンソールが使用できなくなる可能性があります。最初に [[:ja:documentation:07_technical_annexes:07_backup_and_restore_procedures|完全バックアップ]] を実行することをお勧めします。
* Access the **Update manager** → **Offline** menu and press the **Browse it** button to select the downloaded OUM file.
* Click on **Click on file for install**.
* The update will be applied following the same flow of operations as in the online case, showing the dialogs corresponding to the update of the Console and the database, in the event that there are changes in it.
* **アップデートマネージャー(Update manager)** → **オフライン(Offline)** メニューにアクセスし、**参照(Browse it)** ボタンを押して、ダウンロードした OUM ファイルを選択します。
* **インストールするファイルをクリック(Click on file for install)** をクリックします。
* アップデートはオンラインの場合と同じ操作の流れに従って適用され、コンソールやデータベースに変更があった場合には、それに対応するダイアログが表示されます。
In case of updating an installation with High Availability (HA), it will be necessary to take into account what is indicated in [[:en:documentation:05_big_environments:06_ha#actualizacic3b3n|this section]].
高可用性 (HA) 環境にて更新する場合は、[[:ja:documentation:05_big_environments:06_ha#actualizacic3b3n|こちらの章]] に示されている内容を考慮する必要があります。
==== アップデートマネージャのための PHP の追加設定 ====
For Open Update Manager to run correctly you must set the reserved memory to 800 megabytes in the ''php.ini'' file:
オープンアップデートマネージャを正しく実行するには、''php.ini'' ファイルで予約メモリを 800 MB に設定する必要があります。
memory_limit = 800M ; Maximum amount of memory a script may consume
To know the location of the ''php.ini'' file you can use:
''php.ini'' の場所を確認するには、次のコマンドを実行します。
php -i | grep php.ini