.. _widget_installation:

============
Installation
============

*************
Using Sources
*************

All widgets can be download on this page : `<http://www.centreon.com/Content-Download/download-centreon-widgets>`_

Widget packages (.tgz) have to be unpackaged in the centreon/www/widgets directory::

  [root@localhost widgets]# ll
  total 32
  drwxr-xr-x 4 centreon centreon 4096 Dec 17 10:22 dummy
  drwxr-xr-x 4 centreon centreon 4096 Aug 24 15:47 graph-monitoring
  drwxr-xr-x 4 centreon centreon 4096 Aug 24 15:47 hostgroup-monitoring
  drwxr-xr-x 4 centreon centreon 4096 Aug 24 15:47 host-monitoring
  -rw-r--r-- 1 centreon centreon   57 Dec 14 10:19 require.php
  drwxr-xr-x 4 centreon centreon 4096 Aug 24 15:47 servicegroup-monitoring
  drwxr-xr-x 4 centreon centreon 4096 Aug 24 15:47 service-monitoring

**************
Using Packages
**************

You can download all widgets running the following command::

   $ yum install centreon-widget*

It's also possible to install widget one by one replacing centreon-widget* by the name of the widget

****************
Web installation
****************

Then, you need to log in the Centreon web UI and go to [Administration] > [Modules] > [Widget] > [Setup]

.. image:: /_static/images/extending/widgets/install.png
   :align: center
   :width: 750px


At last, click on the Install button:

.. image:: /_static/images/extending/widgets/install_btn.png
   :align: center


Your widget is now ready to be used!


*******
Upgrade
*******

The upgrade process is similar to the installation process, but you will see the *upgrade* button instead:

.. image:: /_static/images/extending/widgets/upgrade_btn.png
   :align: center


**************
Uninstallation
**************

To uninstall a widget, click on this button:

.. image:: /_static/images/extending/widgets/uninstall_btn.png
   :align: center

.. warning::
   Uninstalling a widget will also remove it from all the custom views, do it with caution as widget preferences will not be saved!
