Upcoming Events

Installation

Requirements

This module needs the AWS PHP SDK v2. The newer v3 requires PHP 5.5, a version not available without 3rd party (or SCL) repositories on many Enterprise Linux distributions as of this writing. So to make life easier for many people we decided to work with the older SDK.

Module installation

Please extract or clone this module to your Icinga Web 2 module path. The directory name must fit the module name, aws. This would usually lead to /usr/share/icingaweb2/modules/aws.

Download AWS SDK

Next please download and extract the latest v2 standalone ZIP archive from the AWS PHP SDK releases page. You need to extract the AWS PHP SDK v2 to library/vendor/aws.

AWS key configuration

The last required step is to provide at least one AWS access key in keys.ini. Create a file /etc/icingaweb2/modules/aws/keys.ini as follows:

[My readonly AWS key]
access_key_id = RANDOMANFASDFNASDOFA
secret_access_key = WhatASDmn0asdnfASNDInafsdofdasJ980hansdf

That’s it. Now you are ready to enable the AWS module and you’ll find a new Import Source in your Icinga Director frontend. You are now ready to skip to the Usage section.

Proxy usage

In case your server needs to use a proxy when connection to the AWS web service please create /etc/icingaweb2/modules/aws/config.ini with a network section like shown in this example:

[network]
proxy = "192.0.2.192:3128"

You could also pass proxy credentials in the form user:pass@host:port.

SSL issues

In case you need to provide a specific SSL CA bundle, once again please create a [network] section in your config.ini:

[network]
ssl_ca = "/etc/ssl/certs/ca.pem"