Installation¶
Requirements¶
- Icinga Web 2 (>= 2.5)
- PHP (>= 5.6, preferably 7.x)
- php-gmp
- OpenSSL
- MySQL or MariaDB
- Icinga Web 2 modules:
- reactbundle (>= 0.4) (Icinga Web 2 module)
- Icinga PHP Library (ipl) (>= 0.1) (Icinga Web 2 module)
Database Setup¶
The module needs a MySQL/MariaDB database with the schema that’s provided in the etc/schema/mysql.schema.sql
file.
You may use the following example command for creating the MySQL/MariaDB database. Please change the password:
CREATE DATABASE x509;
GRANT SELECT, INSERT, UPDATE, DELETE, DROP, CREATE VIEW, INDEX, EXECUTE ON x509.* TO x509@localhost IDENTIFIED BY 'secret';
After, you can import the schema using the following command:
mysql -p -u root x509 < etc/schema/mysql.schema.sql
Installation¶
-
Just drop this module to a
x509
subfolder in your Icinga Web 2 module path. -
Log in with a privileged user in Icinga Web 2 and enable the module in
Configuration -> Modules -> x509
. Or use theicingacli
and runicingacli module enable x509
. -
Once you’ve set up the database, create a new Icinga Web 2 resource for it using the
Configuration -> Application -> Resources
menu. -
The next step involves telling the module which database resource to use. This can be done in
Configuration -> Modules -> x509 -> Backend
.
This concludes the installation. You should now be able to import CA certificates and set up scan jobs. Please read the Configuration section for details.