Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fixes #12734: Add documentation for the Centreon plugin #37

Conversation

victorqrt
Copy link
Contributor

This project is part of Rudder - IT automation and compliance made easy.
See: http://rudder-project.org for more information.

This project is also part of iTop - CMDB and ITSM open source software.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what ?


- The Rudder server must have Python installed.

- Generate the Rudder package : make
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we are not in the root directory, say where we should run make


- The Rudder server must have Python installed.

- Generate the Rudder package : make
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should probably add that the rpkg file is available somewhere


- Install the package on the Rudder server : /opt/rudder/bin/rudderpkg install-file <plugin>.rpkg

- Edit the configuration file /opt/rudder/etc/centreon.conf
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what interesting values in this file what do they mean ?

- Install the package on the Rudder server : /opt/rudder/bin/rudderpkg install-file <plugin>.rpkg

- Edit the configuration file /opt/rudder/etc/centreon.conf

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what happens next ?
what sould i do to check if the plugin is working ?

@victorqrt
Copy link
Contributor Author

Commit modified

@victorqrt victorqrt force-pushed the ust_12734/add_documentation_for_the_centreon_plugin branch from 646d1db to 440a72c Compare June 6, 2018 09:03

- The Rudder server must have Python installed.

- Generate the Rudder package : cd into the centreon directory, then make. The .rpkg package file
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if you don't have the binary rpkg file ...

- Generate the Rudder package : cd into the centreon directory, then make. The .rpkg package file
will be generated in the current directory.

- Install the package on the Rudder server : /opt/rudder/bin/rudderpkg install-file <plugin>.rpkg
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

isn't there a markdown syntax for commands ?

- Edit the configuration file /opt/rudder/etc/centreon.conf. This config file has to contain your Centreon
server's webservice API URL, the credentials to access it, and the name of the Centreon poller used to
monitor Rudder nodes (Central by default). You also need to provide the Rudder API URL, and a token to access
it, which you can issue from the Rudder server webapp or CLI.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

" from the Rudder server webapp or CLI" this is too generic, either say how to get it or don't say anything.
The best would be a pointer to a Rudder documentation url that already has the information.


Centreon comes with the possiblity to add monitoring templates to its hosts. You can create templates in
Centreon or check for available ones. Once you know the name of a template suitable for a Rudder node/nodegroup,
you can add it using the "Monitoring template" generic method from the technique editor.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How long to i need to wait to make sure the template is applied ?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

a word about the cron/daemon that process those templates and how it works ?

-----

Now that the plugin is installed, you can check if it is working by adding new Rudder nodes. They will be added
to you list of Centreon hosts (and removed on deletion of the Rudder node).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add a sentence to briefly describe how it works : post-hook, api call from rudder server ...

@victorqrt
Copy link
Contributor Author

Commit modified

@victorqrt victorqrt force-pushed the ust_12734/add_documentation_for_the_centreon_plugin branch from 440a72c to 086f3ef Compare June 7, 2018 15:40
-----

Now that the plugin is installed, you can check if it is working by adding new Rudder nodes. They will be added
to you list of Centreon hosts (and removed on deletion of the Rudder node).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

to your list

Usage
-----

Now that the plugin is installed, you can check if it is working by adding new Rudder nodes. They will be added
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

automatically added

options on such events.

Centreon comes with the possiblity to add monitoring templates to its hosts. You can create templates in
Centreon or check for available ones. Once you know the name of a template suitable for a Rudder node/nodegroup,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suitable template

hosts. The "Monitoring parameter" generic method achieves this.

The data will be sent hourly to the Centreon server. This can be changed by editing the /etc/cron.d/centreon-rudder file.
This operation can be manually executed by running
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

running where ?

@victorqrt
Copy link
Contributor Author

Commit modified

@victorqrt victorqrt force-pushed the ust_12734/add_documentation_for_the_centreon_plugin branch from 086f3ef to 39ff55e Compare June 11, 2018 09:19
@Normation-Quality-Assistant
Copy link
Contributor

OK, merging this PR

@Normation-Quality-Assistant Normation-Quality-Assistant merged commit 39ff55e into Normation:branches/rudder/4.1 Jun 15, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
3 participants