Centctl is a CLI which allows to manage Centreon servers. Centctl use a file named config.yaml for manage the connection at differents servers.
Developped in Go, it allows to operate a Centreon platform remotely from a PC under Windows, Linux or Macos without any particular installation.

Create a file called config.yaml in the root of the project
For declare a server use the configuration below by replacing capitalized words

• NAMESERVER it's the name of the server that you will use in the flag --server. WARNING : The name of the server must be unique
• URL it's the url at use for access to your centreon server. Its format is https://monserveurcentreon.fr/centreon and you replace monserveurcentreon.fr by the server. WARNING : remember to put http if your url is not a secure url
• LOGIN it's the login that you use for the connection at the server
• PASSWORD it's the password that you use for the connection at the server

servers:
   - server: "NAMESERVER"
     url: "URL" 
     login: "LOGIN"
     password: "PASSWORD"
   - server: "NAMESERVER2"
     url: "URL" 
     login: "LOGIN"
     password: "PASSWORD"

Create a file with the extension .csv in the root of the project
You can create contact, host and service. The first column is to specified the object. The syntax is :

contact,full name,login,email,password,admin
host,name,alias,IPaddress,templateHost,pollerName,hostGroup
service,hostName,description,templateService

The following table shows you an example for each case:

WARNING : when a host has not host group and when a contact is not admin, think to put the comma in the end of line. You can write comments in your csv file using a # at the beginning of the line. Example: #It's a comment and this line is not analysed by the program
For export the CSV file use the command next : centctl export -f nameFile.csv --server nameServer
When exporting all objects is complete, the nameFile.csv is deleted and a file named donenameFile.csv is created and contains all object created. Otherwise, an error which specifie the problem appear in the terminal.

You can install it with apt-get install bash-completion

The above commands create /usr/share/bash-completion/bash_completion, which is the main script of bash-completion. Depending on your package manager, you have to manually source this file in your ~/.bashrc file.

To find out, reload your shell with command source ~/.bashrc and run type _init_completion. If the command succeeds, you’re already set, otherwise add the following to your ~/.bashrc file:

source /usr/share/bash-completion/bash_completion

Reload your shell and verify that bash-completion is correctly installed by typing type _init_completion

Add the completion script to the /etc/bash_completion.d directory:

centctl completion >/etc/bash_completion.d/centctl

After reloading your shell, centctl autocompletion should be working.

Note : Centreon, the Centreon Logo, are trademarks, servicemarks, registered trademarks or registered servicemarks owned by Centreon Software. All other trademarks, servicemarks, registered trademarks, and registered servicemarks are the property of their respective owner(s). CentCtl is not endorsed nore supported by Centreon Software and use only external API based on Centreon Plateform.