アップグレード [wiki.pandorafms.jp]

この文書は読取専用です。文書のソースを閲覧することは可能ですが、変更はできません。もし変更したい場合は管理者に連絡してください。
====== アップグレード ======

{{indexmenu_n>2}}


[[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]

===== ワープアップデート (アップデートマネージャ) =====

<WRAP center round info 60%>

If you have version 762 (or earlier) installed, use the [[:en:documentation:02_installation:02_anexo_upgrade#automatic_update_with_update_manager|Update Manager]].

</WRAP>

<WRAP center round info 60%>
バージョン 762 (およびそれ以前)の場合は、[[:ja:documentation:02_installation:02_anexo_upgrade#アップデートマネージャを使った自動アップデート|アップデートマネージャ]] を利用してください。
</WRAP>

  * This section will only be visible if **Enable Warp Update** is activated in the [[:en:documentation:04_using:12_console_setup#enterprise|General Configuration]].
   * 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.
   * **Warp Update** will contact you to find the latest version available (on SourceForge).
   * Updates are automatic and in 99% of cases it works successfully if the environment is correctly configured.
   * You can also [[:en:documentation:02_installation:02_anexo_upgrade#warp_update_offline|update offline (offline)]] if the PFMS server to be updated is in a restricted and/or limited environment.

  * これは、[[:ja:documentation:04_using:12_console_setup#enterprise|一般設定]] で **ワープアップデートの有効化(Enable Warp Update)** が有効になっている場合のみ表示されます。
  * Pandora FMS コンソールおよびサーバから、[[:ja:documentation:07_technical_annexes:15_security_architecture#システムを最新の状態に保つ|インターネットへの接続]]ができる必要があります。
  * **ワープアップデート(Warp Update)** は、(Sourceforge 上で)利用可能な最新バージョンを見つけるためにサーバに接続します。
  * 更新は自動的に行われ、99% 正常に機能するはずですが、必ず機能することを保証するわけではありません。
  * 更新する Pandora FMS サーバがインターネット接続を制限された環境にある場合は、[[:ja:documentation:02_installation:02_anexo_upgrade#オフラインワープアップデート|オフライン更新]] することもできます。

==== オンラインワープアップデート ====

  * In order to update through **Warp Update**  online, you must be registered.
  * Warp Update will connect to our servers and analyze what updates are needed.
  * If it is up to date, it will show the active version in progress, without the need to carry out any other action.

  * オンラインの **ワープアップデート** でアップデートするためには登録が必要です。
  * ワープアップデートが我々のサーバに接続し、必要な更新を分析します。
  * すでに最新の場合は、他のアクションを実行することなく現在アクティブなバージョンが表示されます。

==== オフラインワープアップデート ====

[[https://pandorafms.com/en/prices/?o=dwpfms|{{:wiki:icono-modulo-enterprise.png?nolink&23x23  |Versión Enterprise}}]]For Enterprise environments you can upgrade //offline//. [[https://pandorafms.com/en/contact/|Contact]] support for downloading the files.

[[https://pandorafms.com/en/prices/?o=dwpfms|{{:wiki:icono-modulo-enterprise.png?nolink&23x23  |Enterprise 版}}]]Enterprise 環境ではオフラインでアップグレードすることができます。ファイルをダウンロードするには、[[https://pandorafms.com/ja/contact/|サポートへ連絡ください]]。

Warp Update Offline also serves to install //patches// of different types: console (**OUM**), server (''tar.gz'') and manual combined //patches// (''tar.gz'').

オフラインワープアップデートは、さまざまなタイプの //パッチ// をインストールすることもできます: コンソール (**OUM**)、サーバ (''tar.gz'')、および手動で組み合わせた //パッチ// (''tar.gz'')。

<WRAP center round important 60%>

Applying patches and/or updates offline may make your Web Console unusable, it is recommended to perform a [[:en:documentation:07_technical_annexes:07_backup_and_restore_procedures|full backup]] beforehand.

</WRAP>

<WRAP center round important 60%>

オフラインパッチを適用すると、コンソールが使用できなくなる可能性があります。事前にファイルの[[https://pandorafms.com/manual/ja/documentation/07_technical_annexes/07_backup_and_restore_procedures|フルバックアップ]]をお勧めします。

</WRAP>

  * In the case of a version upgrade, you must download the corresponding **OUM** and ''tar.gz'', install the **OUM** first and then the //tarball//.
  * Once the file(s) have been downloaded, access the **Warp Update** → **Warp Update Offline** menu and click the **Browse it** button to select file by file.
  * Review the information displayed on the screen and check if it matches the updates and/or corrections. To process click on the green icon in the lower right corner, wait for the console to display the results of each process.

  * バージョンのアップグレードの場合は、対応する **OUM** と ''tar.gz'' をダウンロードし、最初に **OUM** をインストールし、次に //tarball// をインストールする必要があります。
  * ダウンロードしたら、**ワープアップデート(Warp Update)** → **オフラインワープアップデート(Warp Update Offline)** メニューへ行き、ファイル選択のために **ブラウズする(Brouse it)** をクリックします
  * 画面に表示された情報を確認し、更新または修正と一致するかどうかを確認してください。 処理するには、右下隅にある緑色のアイコンをクリックし、コンソールに各処理の結果が表示されるまで待ちます。

==== ワープアップデート履歴 ====

Go to **Warp Update** → **Warp Update Journal** menu to find out the updates made, version, date and time of application, user who requested and applied it, etc.

行われた更新、バージョン、アプリケーションの日時、それを要求して適用したユーザなどを確認するには、**ワープアップデート(Warp Update)** → **ワープアップデート履歴(Warp Update Journal)** メニューへ行きます。

==== ワープアップデート設定 ====

<WRAP center round tip 60%>

**Enterprise version**: [[https://pandorafms.com/en/contact/|Contact]] support before changing any of the following fields:

  * **Warp Update URL**.
  * **Use secured Warp Update**.
  * **Proxy server**.
  * **Proxy port**.
  * **Proxy user**.
  * **Proxy password**.
</WRAP>

<WRAP center round tip 60%>
**Enterprise 版**: 以下のフィールドを変更する前に[[https://pandorafms.com/ja/contact/|お問合せ]]ください。

  * **ワープアップデート URL(Warp Update URL)**
  * **セキュアなワープアップデートの利用(Use secured Warp Update)**
  * **プロキシサーバ(Proxy server)**
  * **プロキシポート(Proxy port)**
  * **プロキシユーザ(Proxy user)**
  * **プロキシパスワード(Proxy password)**
</WRAP>

   * **Allow no-consecutive patches**: Allows non-consecutive updates to be installed. Off by default and is the recommended option.
   * **Limit to LTS updates**: Allows you to update only long-term versions, active by default.

  * **連続しないパッチを許可する(Allow no-consecutive patches)**: 連続しない更新をインストールできるようにします。 デフォルトでは無効になっており、無効が推奨です。
  * **LTS アップデートに制限(Limit to LTS updates)**: 長期サポートバージョンのみでの更新ができます。デフォルトで有効です。


===== 手動アップデート =====

  * Pandora FMS has three main elements: console (Open source version), server and database.
  * In **Enterprise**  installations, the process will take a few more steps than the Open version.
      * Enterprise Web Console (Console extended features).
      * Enterprise Server (Server extended features).
      * Database (additional Enterprise version tables).
  * Updates will **always**  include changes to the console, **sometimes**  server changes (minor updates) and **rarely**  database changes (major updates).

  * Pandora FMS は、コンソール、サーバ、データベースの 3つの要素に分けることができます。
  * **Enterprise 版**では、オープンソース版に比べて追加で対応する必要がある内容があります。
      * Enterprise ウェブコンソール (コンソールの拡張機能)
      * Enterprise サーバ (サーバ拡張機能)
      * データベース (Enterprise 版追加テーブル)
  * 更新には、**常に** コンソールの変更、**時々** サーバの変更、**まれに** データベースの変更(メジャーアップデート)を含みます。

==== マイナーバージョンアップ ====

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|バックアップ]]します。例:
<code>

  mysqldump -u root -p pandora > backup_pfms_X.Y.sql

</code>

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. サーバおよびエージェントプラグインを次のようにバックアップします。

<code>
/etc/pandora/plugins
pandora_console/attachment/plugin
/usr/share/pandora_server/util/plugin
</code>

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 パッケージにて ===

Download the version after the one you have installed:

インストールするバージョンをダウンロードします。

<WRAP center round download 90%>

[[https://firefly.pandorafms.com/pandorafms/|https://firefly.pandorafms.com/pandorafms/]]

</WRAP>

  * Open console update:

  * オープンソースのコンソールアップデート:

<code>

rpm -U pandorafms_console*.rpm

</code>

  * [[https://pandorafms.com/en/prices/?o=dwpfms|{{:wiki:icono-modulo-enterprise.png?nolink&23x23  |Enterprise version}}]]Enterprise console update:

  * [[https://pandorafms.com/en/prices/?o=dwpfms|{{:wiki:icono-modulo-enterprise.png?nolink&23x23  |Enterprise 版}}]]Enterprise コンソールアップデート:

<code>

rpm -U pandorafms_console_enterprise_package.rpm

</code>

  * Open server update:

  * オープンソースサーバアップデート:

<code>
rpm -U pandorafms_server*.rpm

</code>

  * [[https://pandorafms.com/en/prices/?o=dwpfms|{{:wiki:icono-modulo-enterprise.png?nolink&23x23  |Enterprise version}}]]Enterprise server update with tar.gz:

  * [[https://pandorafms.com/en/prices/?o=dwpfms|{{:wiki:icono-modulo-enterprise.png?nolink&23x23  |Enterprise 版}}]]tar.gz での Enterprise サーバアップデート:

<code>

tar -xvzf pandorafms_server_enterprise_package.tar.gz
cd pandora_server
./pandora_server_installer --install

</code>

  * Software Agent update:

  * ソフトウエアエージェントアップデート:
<code>
rpm -U pandorafms_agent*.rpm

</code>

You can find out which version you have installed at any time, before or after the installation by executing the command:

インストール前後で、どのバージョンで動いているか、以下のコマンドで確認できます。

<code>
rpm -qa | grep -i pandora

</code>

=== tar ボール、ソースにて ===

   * You must visit [[https://firefly.pandorafms.com/pandorafms/|https://firefly.pandorafms.com/pandorafms/]] and download the version after the one installed.
   * Change ''package'' to the name of the downloaded version and ''yourconsolepath'' to the full path of the installed console.
   * Open Source Console Update:

  * [[https://firefly.pandorafms.com/pandorafms/|https://firefly.pandorafms.com/pandorafms/]] へ行き、インストールしたバージョンより新しいものをダウンロードします。
  * ''package'' をダウンロードしたバージョンの名前に置き換え、''yourconsolepath'' をインストールされているコンソールのフルパスに置き換えます。
  * オープンソースコンソールアップデート:

<code bash>
tar xvzf pandorafms_console_'package'.tar.gz
cd pandora_console
./pandora_console_upgrade -p /'yourconsolepath'


</code>

  * [[https://pandorafms.com/en/prices/?o=dwpfms|{{:wiki:icono-modulo-enterprise.png?nolink&23x23  |Enterprise version}}]]Enterprise console update:

  * [[https://pandorafms.com/en/prices/?o=dwpfms|{{:wiki:icono-modulo-enterprise.png?nolink&23x23  |Enterprise 版}}]]Enterprise コンソールアップデート:

<code bash>
tar xvzf pandorafms_console_enterprise_'package'.tar.gz
cd pandora_console
./pandora_console_upgrade -p /'yourconsolepath'


</code>

   * Open Source server update:

  * オープンソースサーバアップデート:

<code bash>
tar xvzf pandorafms_server_'package'.tar.gz
cd pandora_server
./pandora_server_upgrade --upgrade


</code>

  * [[https://pandorafms.com/en/prices/?o=dwpfms|{{:wiki:icono-modulo-enterprise.png?nolink&23x23  |Enterprise version}}]]Enterprise server update:

  * [[https://pandorafms.com/en/prices/?o=dwpfms|{{:wiki:icono-modulo-enterprise.png?nolink&23x23  |Enterprise 版}}]]Enterprise サーバアップデート:

<code bash>
tar xvzf pandorafms_server_enterprise_'package'.tar.gz
cd pandora_server
./pandora_server_upgrade --upgrade


</code>

  * ソフトウエアエージェントアップデート:

<code bash>
tar xvzf pandorafms_agent_'package'.tar.gz
cd pandora_agent
./pandora_agent_installer --force-install


</code>


==== メジャーアップデート ====

Version 7.0 NG Rolling Release

バージョン 7.0 NG ローリングリリース

It is always recommended to update the console using **Update Manager**. In case of having an outdated database, 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 コンソールがインストールされているサーバに入り、次のディレクトリに移動します。

<code>
/var/www/html/pandora_console/extras/mr

</code>

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) の実行例:

<code>
cat 1.sql | mysql -u root -p pandora

</code>

Once the **SQLs** have been applied to the database, go to the directory called ''updated''.

データベースに **SQL** を適用したら、適用したファイルを ''updated'' ディレクトリに移します。

<code>

mkdir -p updated
mv 1.sql updated/

</code>

Then update the **MR** value within the ''tconfig'' table of MySQL:

そして、MySQL の ''tconfig'' テーブルにある **MR** の値を更新します。

<code>
mysql -u root -p pandora> use pandora;> update tconfig set value= XX where token='MR';

</code>

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|こちら]]を確認してください。


===== アップデートマネージャを使った自動アップデート =====

   * 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** ボタンをクリックして更新処理を終了します。



==== Enterprise 版の更新 ====

Unlike Open Source updates, these have some additional features:

オープンソース版の更新とは異なり、追加の特徴があります。

   * 100% tested and verified by the development team so you can enjoy daily updates (sometimes within a few hours after opening a ticket).

  * 開発チームによって 100% テストされています。そのため、公開されたと同時に(もしくは数時間以内に)更新することができます。

   * Targeted (incremental) updates that allow you to update only what is out of date, without downloading heavy packages from the Internet.

  * 大きなパッケージをダウンロードする必要はなく、更新されたもののみを適用することができます。

   * Allows offline updates, downloading packages from the support page, for installations ofPandora FMS that do not have an Internet connection (for security).

  * オフラインの更新ができます。サポートページからダウンロードして、(セキュリティの理由等で)インターネットに接続されていない Pandora FMS に適用できます。

{{:wiki:icono-modulo-enterprise.png |Enterprise 版}}

To be able to use **Update Manager** in the Enterprise version, you must first have correctly configured that software for updates, which has its own section in the **Update manager** menu → **Update manager options**.

Enterprise 版で **アップデートマネージャー(Update Manager)** を使用できるようにするには、まずアップデート用の設定を正しく行う必要があります。この設定には、**アップデートマネージャー(Update manager)** メニュー → **アップデートマネージャーオプション(Update manager options))** に独自のセクションがあります。

==== オープンソースオンラインアップデート ====

The process is similar to the Enterprise version but without the additional step of license verification.

このプロセスは Enterprise 版と似ていますが、ライセンス認証の追加手順はありません。

==== Enterprise オフラインアップデート ====

{{:wiki:icono-modulo-enterprise.png?23x23 |Enterprise Version}}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.

{{:wiki:icono-modulo-enterprise.png?23x23 |Enterprise 版}}拡張子 ''.OUM'' の Pandora FMS オフラインアップデートファイルをダウンロードできます。ダウンロードは、Pandora FMS の公式サポートページから行います。不明な場合は、[[https://pandorafms.com/ja/contact/|お問い合せ]]ください。

<WRAP center round important 60%>

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.

</WRAP>

<WRAP center round important 60%>

オフラインパッチを適用すると、コンソールが使用できなくなる可能性があります。最初に [[:ja:documentation:07_technical_annexes:07_backup_and_restore_procedures|完全バックアップ]] を実行することをお勧めします。

</WRAP>

   * 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)** をクリックします。
   * アップデートはオンラインの場合と同じ操作の流れに従って適用され、コンソールやデータベースに変更があった場合には、それに対応するダイアログが表示されます。

<WRAP center round important 60%>

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]].

</WRAP>

<WRAP center round important 60%>

高可用性 (HA) 環境にて更新する場合は、[[:ja:documentation:05_big_environments:06_ha#actualizacic3b3n|こちらの章]] に示されている内容を考慮する必要があります。

</WRAP>

==== アップデートマネージャのための 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 に設定する必要があります。

<code>

memory_limit = 800M ; Maximum amount of memory a script may consume

</code>

To know the location of the ''php.ini'' file you can use:

''php.ini'' の場所を確認するには、次のコマンドを実行します。

<code>
php -i | grep php.ini

</code>


===== ダウングレード =====


==== RPM パッケージより ====

  * オープンソースのコンソールアップデート:

<code>
rpm -i --force pandorafms_console_package.rpm

</code>

  * Enterprise 版コンソールのアップデート:

<code>
rpm -i --force pandorafms_console__enterprise_package.rpm

</code>

==== Tarball/ソースコードより ====

  * オープンソースのコンソールアップデート:

<code>
tar -xvzf pandorafms_console_package.tar.gz
mv --force ./pandora_console/* /yourconsolepath

</code>

  * Enterprise 版コンソールのアップデート:

<code>
tar -xvzf pandorafms_console_package.tar.gz
mv --force ./enterprise /yourconsolepath

</code>

[[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]

===== OBSOLETE =====

=== データベースのアップデート ("メジャーリリース") ===

データベースをアップデートするには、最初にバージョンに応じたオープンソースおよび Enterprise コンソールをアップデートする必要があります。これらのアップデートによって必要な SQL ファイルをダウンロードできます。

コンソールをアップデートしたら、SQL のデータベースアップデートスクリプトがコンソールの /extras や /enterprise に見つかります(バージョンに依存します)。CentOS の場合であれば、以下にあります。

<code>
/var/www/html/pandora_console/extras/pandoradb_migrate_X.Y_to_Z.T.mysql.sql
</code>

<code>
/var/www/html/pandora_console/enterprise/pandoradb_migrate_vX.Y_to_vZ.T.mysql.sql
</code>

アップデートの前に最初に説明した、データベース、設定ファイルのバックアップ、Pandora FMS サーバの停止といった準備を行います。

<code>
service pandora_server stop

</code>

  * オープンソースデータベースのアップデート:

<code>
mysql -u ユーザ名 -p -D データベース名

</code>

例:

<code>
mysql -u pandora -p -D pandora

</code>

MySQL コマンドラインで以下を実行します。

<code>
source /yourconsolepath/extras/pandoradb_migrate_X.Y_to_Z.T.mysql.sql;

</code>

<WRAP center round tip 60%> オープンソース版のマイグレーションを実行すると、Enterprise 版もアップデートされます。 </WRAP>

MySQL から抜けるには "quit" を実行します。以上でデータベースがバージョンに合わせてアップデートされました。

以前のバージョンに戻す必要がある場合は、以下のようにバックアップからリストアします。

<code>
mysql -u username -p databasename
> drop database databasename;
> create database newdatabasename;
> use newdatabasename;
> source backup_pfms_X.Y.sql
</code>

<code>
mysql -u ユーザ名 -p データベース名
> drop database データベース名;
> create database 新たなデータベース名;
> use 新たなデータベース名;
> source backup_pfms_X.Y.sql

</code>

例:

<code>
mysql -u root -p pandora
> drop database pandora;
> create database pandora;
> use pandora;
> source backup_pfms_X.Y.sql;
</code>


==== オープンソース版の更新 ====

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つの選択肢があります。

<WRAP center round tip 60%> アップデートマネージャが動作するためにはインターネットへの接続が必要です。パッケージのダウンロードに、デフォルトでは wget を利用します。curl を利用することもできます(Pandora の設定で変更します)がさほど早くありません。 </WRAP>

処理が終わると、メインのアップデートページにコンソールのバージョンが表示されます。 おめでとうございます、これが表示されればアップデート成功です。

{{  :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  }}

アップデートは、オンラインのダウンロードと同じフローです。適用する変更がある場合、関連するコンソールおよびデータベースのアップデートダイアログが表示されます。

<WRAP center round tip 60%> 我々のチームが提供している zip ファイルを使っても、同じ方法で Pandora コンソールをアップデートできます。 </WRAP>

<WRAP center round important 60%> HA 構成のシステムをアップデートする場合は、[[:ja:documentation:05_big_environments:06_ha|こちらのドキュメント]] を参照してください。 </WRAP>

==== 他のシステムへのマイグレーション ====

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:

  * 次のコマンドを使用して、データベースの論理コピーを作成することから始めます。

<code>

mysqldump --single-transaction --max_allowed_packet=512M -u root -p pandora> backup_pandora_X.Y.sql

</code>

  * 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 サーバ設定を圧縮します。

<WRAP center round important 60%> \\ 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. \\ </WRAP>

<WRAP center round important 60%> \\ データの保護は作業するあなたにかかっています。 データを移動するために行う手順は書き留めておきましょう。 処理を行う際は複数人で手順やバックアップを確認するなど、十分**注意**してください。\\ </WRAP>

**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_サーバの手動起動停止|追加オプション]] があります)。

<code>

 /etc/init.d/pandora_server stop
 /etc/init.d/pandora_agent_daemon stop
 /etc/init.d/tentacle_serverd stop

</code>

**4.-**  To stop the Apache server will depend on the distribution you are using:

**4.-**  Apache サーバを停止するには、使用しているディストリビューションに合わせて以下のいずれかを実行します。

<code>
/etc/init.d/apache2 stop

</code>

<code>
/etc/init.d/httpd stop

</code>

<code>
systemctl stop httpd.service

</code>

**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'' です。そして、データベースをインポートします。

<code>
 # mysql -u root -p
 mysql>use pandora
 Database changed
 mysql>source ~/backup_pandora_X.Y.sql

</code>

//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'' を変更します。

<code>

# 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';

</code>

//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'' を使うことを想定した場合の例は次の通りです。

<code>
# mysql -u root -p> grant all privileges on pandora.* to 'pandora1'@'localhost' identified by 'pandora2';> flush privileges;

</code>

**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#エージェント一括編集|一括操作のエージェント編集]] を利用します。

<WRAP center round info 60%> \\ If it is the Enterprise version, follow the same procedure. \\ </WRAP>

<WRAP center round info 60%> \\ この手順は、Enterprise 版であっても同様です。</WRAP>