Integrate > Icinga > Install > Installation Prerequisites

Installation Prerequisites

This section lists the prerequisites to enable installation of OpsCx for Icinga.

Application Software

Before you install OpsCx for Icinga, the following software applications must be installed and configured.

Application Required Version
Operations Manager i (OMi)

10.11 or later

OpsCx

10.11, patched with the hotfix QCCR8D95037. Contact Support to get the hotfix.

OpsCx must be configured as a connected server and properly integrated into OMi

For information on installation and configuration, see the corresponding documentation.

TCP/IP Ports

The following table lists the ports that OpsCx for Icinga uses by default. In your OpsCx environment, these ports may not be used by other software applications.

Port Number Port Description
5665

Default port on which OpsCx for Icinga listens for incoming Icinga events.

If Icinga and OpsCx communicate through a firewall, make sure the firewall rules allow connections through this port.

30005

Default port of OpsCx policies of the REST Web Service Listener type.

Used for dispatching OpsCx for Icinga events to the respective OpsCx policies.

If you cannot ensure the default ports are free, you can still change the port numbers while configuring OpsCx for Icinga. Keep in mind that changing the port numbers includes mandatory actions also in the third-party system management application or OpsCx.

Other Prerequisites and Requirements

The following is a list of additional prerequisites and the requirements you must consider before installing the product:

  • OpsCx for Icinga supports only TLSv1.2 for secure connection. For a successful connection and data collection, the Icinga Domain Manager should also support the same version.
  • Make sure to have valid REST API credentials (username/ password) to have access to the Icinga REST API. The credentials and permissions can be configured during Icinga (Domain Manager) configuration. By default * which means all permission will be configured. However, minimum permissions needed for the connector to make REST query is:

    permissions = [ "objects/query/Host", "events/StateChange", "actions/acknowledge-problem" ]

    This permissions are configurable. For more information, see Icinga Documentation.

  • To configure and administer OpsCx for Icinga, familiarize yourself with OMi. For example, you can learn how to customize Management Templates, Aspects and Policies. For more information, see the OMi Administration section.