Get started with Opsgenie as a user
Learn how to configure your profile, get notifications from Opsgenie and view on-call schedules.
Marid is deprecated and will be permanently retired on November 21st, 2022. Read the community post for more details.
If you never used our extensibility platform before, visit Opsgenie Edge Connector as an extensibility platform to find out how to run it with your Opsgenie account.
If you're using Marid and want to migrate to Opsgenie Edge Connector, visit Why should you migrate to Opsgenie Edge Connector.
Watch Opsgenie Marid: Connecting On-Premise Monitoring and ITSM Tools for an overview of Marid.
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:
Prerequisites:
Oracle/OpenJDK Java SE 8 or 11 (LTS) Required.
Installation Steps for Red Hat Based Distributions
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
Run following command to install Lamp and Marid:
dpkg -i opsgenie-marid-<your_version>.deb
Installation Steps for Windows (and other OS distributions)
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"
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
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.
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
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.
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
The source code is available at GitHub.
Was this helpful?