openITCOCKPIT Agent

Download

Direct package downloads

Windows



Requires Microsoft .NET Framework 3.5 or 4.5^

macOS



Ubuntu




Debian




openSUSE




Red Hat




CentOS




Arch Linux




Installation instructions

Windows

Graphical installation steps

Please make sure you have installed Microsoft .NET Framework 3.5 or 4.5^.

Windows check for .NET Framework 3.5

Double-click the downloaded file to install the openITCOCKPIT Agent. Click Next to proceed with the installation.

openITCOCKPIT Agent

If you unsure what option you should pick please read the following help section.

Step 1
The Agent is licensed with the common Apache 2 license. Read it, if you accept it, set a tick in the box and procees with the Next button.
Step 2
If you don´t want to change the default installation path click Next and confirm the installation with Install:
Step 3
Confirm that you want to run the oitcAgent.msi and wait until the installation is finished.

Manual
Install:
msiexec.exe /i openitcockpit-agent-1.0.0.msi INSTALLDIR="C:\Program Files\it-novum\openitcockpit-agent\" /qn
Uninstall:

Use the windows built-in graphical package manager


macOS

Graphical installation steps
Install:

Double-click the downloaded file to install the openITCOCKPIT Agent. Click Next to proceed with the installation.

openITCOCKPIT Agent

If you unsure what option you should pick please read the following help section.

Step 1
Step 2
Step 3
Uninstall:

Download uninstaller

Step 1
Step 2

Manual
Install:
sudo installer -pkg openitcockpit-agent-1.*.pkg -target / -verbose
Uninstall:

Download uninstaller

sudo installer -pkg openitcockpit-agent-uninstaller*.pkg -target / -verbose

Ubuntu + Debian

From repository
curl https://packages.openitcockpit.io/repokey.txt | sudo apt-key add

sudo echo "deb https://packages.openitcockpit.io/openitcockpit/$(lsb_release -sc)/nightly $(lsb_release -sc) main" > /etc/apt/sources.list.d/openitcockpit.list
sudo apt-get update
Install:
sudo apt-get install openitcockpit-agent
Uninstall:
sudo apt-get remove openitcockpit-agent

Manual
Install:
sudo apt-get install ./openitcockpit-agent_*_amd64.deb
Uninstall:
sudo apt-get remove openitcockpit-agent

openSUSE

From repository
Install:
sudo zypper in openitcockpit-agent
Uninstall:
sudo zypper rm openitcockpit-agent

Manual
Install:
sudo rpm -i openitcockpit-agent-*.x86_64.rpm
Uninstall:
sudo rpm -e openitcockpit-agent

Arch

Manual
Install:
sudo pacman -U openitcockpit-agent-*-x86_64.pkg.tar.xz
Uninstall:
sudo pacman -R openitcockpit-agent

Usage

Usage in openITCOCKPIT

First of all log in to the webinterface of your openITCOCKPIT.

If you have already an host configured for the machine the Agent is running on, navigate to Administration openITCOCKPIT Agent Agent Configuration. Choose the host the agent is installed on and follow the instructions there.

If you haven´t configured a host for the machine the Agent is running on yet, navigate to Monitoring Hosts and click + New. After your host configuration click Create host and setup agent to save the host and proceed directly with the built-in agent configuration.


Manual

After the installation the Agent runs automatically and should be available at http://localhost:3333. There you can get a JSON result after a few seconds. It contains all default check results.