Marid Overview & Installation

📘
Marid is not available under Free and Essentials Plans. Please upgrade to a Standard or Enterprise Plan to use this feature.

Marid is an integration server for Opsgenie. It is designed to resolve challenges faced in the integration of internal and external systems. Core capabilities include:

Install Marid

Prerequisites:

Oracle JRE version 1.6 and above or OpenJDK version 6 and above

🚧
Marid will only work with Java 1.7 or above in the Opsgenie European Service Region.

Installation Steps for Red Hat Based Distributions

Download Opsgenie Marid package
Run following command to install Lamp and Marid:

rpm -i opsgenie-marid-<your_version>.rpm

🚧
During upgrades, rpm package does not overwrite your existing configurations. It saves the new default configuration file as marid.conf.rpmnew. You can find more information about rpm upgrade config file handling from here.

Installation Steps for Debian Based Distributions

Download Opsgenie Marid package
Run following command to install Lamp and Marid:
dpkg -i opsgenie-marid-<your_version>.deb

Installation Steps for Windows (and other OS distributions)

Download Opsgenie Marid package
Unzip opsgenie marid zip file which contains into a directory (C:\marid is the preferred path. C:\marid will be referred to as MARID_HOME in the rest of documentation.)
To install Marid as a service:

Open a command window
Go to <MARID_HOME> directory
For 32 bit systems, run marid.exe -install
For 64 bit systems, run marid_64.exe -install

Name of the service will be assigned to "Opsgenie Marid"
4. You can also use this ZIP package in the Linux distributions in case you would not like to install the RPM or DEB packages.

📘
To set JAVA_HOME environment variable, refer to Setting JAVA_HOME for more information.

📘
To enable Ruby scripting, you need to download JRuby Complete jar file and put this jar file in lib directory (/var/lib/opsgenie/marid On Linux, MARID_HOME/lib on Windows systems.).

🚧
You may need to restart your system after setting JAVA_HOME environment variable for Windows XP/2000/2003 operating systems due to problem reported at http://support.microsoft.com/kb/821761

Marid Configuration

Application Configuration

If you download stand-alone opsgenie-marid package, Marid application configuration file is located in:

For Windows: <MARID_HOME>/conf/marid.conf
For Linux: /etc/opsgenie/marid/marid.conf

If you are using marid, within an integration package(nagios, zabbix, zenoss etc.), Marid application configuration file is located in:

/etc/opsgenie/conf/opsgenie-integration.conf

Depending on what Marid will be used for, different configuration parameters need to be defined.

JVM Configuration

You can change JVM settings like max/min memory, garbage collection settings, etc. by modifying application configuration files depending on your operating system.

On Linux
You should modify MARID_JVM variable in /etc/opsgenie/profile file. For example to set max memory to 1024 MB you should change MARID_JVM as:

MARID_JVM=" -Xmx1024m $MARID_JVM"

On Windows

For 32-bit Windows

You should modify JVM settings in <MARID_HOME>/marid.vmoptions file. For example to set max memory to 1024 MB you should change -Xmx setting as

-Xmx1024m

For 64-bit Windows

You should modify JVM settings in <MARID_HOME>/marid_64.vmoptions file. For example to set max memory to 1024 MB you should change -Xmx setting as

-Xmx1024m

Log Configuration

Marid log configuration file is located in:

For Windows: <MARID_HOME>/conf/log.properties
For Linux: /etc/opsgenie/marid/log.properties

This is a standard Apache Log4J configuration file. You can change log levels, log file names, appender settings, etc. Please refer to Apache Log4J Manual for a complete list of Log4J settings.

For example in order to change log level of script logger to DEBUG from WARN you should change log4j.logger.script=WARN, script as log4j.logger.script=DEBUG, script

🚧
Marid log files will be written to (Will be referred as LOGS_DIR in the rest of documentation.):

On Linux: /var/log/opsgenie/marid

On Windows: MARID_HOME/logs

🚧
Marid does not support SSL v1.0. If you are using Marid with a server that has SSL v1.0, we suggest you to upgrade your SSL server.

Start / Stop

On Linux

/etc/init.d/marid start
/etc/init.d/marid stop

On Windows

For 32 bit : marid.exe -start / marid.exe -stop
For 64 bit : marid_64.exe -start / marid_64.exe -stop
Or For 32 bit & 64 bit : Start /Stop the service from Windows service control panel

Source

The source code is available at GitHub.