---
title: "Observium Client Setup Script"
id: "37"
type: "post"
slug: "observium-client-install-script"
published_at: "2013-12-15T13:08:54+00:00"
modified_at: "2015-01-08T23:51:38+00:00"
url: "https://www.sonicboxes.com/observium-client-install-script/"
markdown_url: "https://www.sonicboxes.com/observium-client-install-script.md"
excerpt: "Observium is a neat PHP based system monitoring platform that I’ve been using lately, it’s fairly easy to install (Observium + Nginx/PHP-FPM install guide Coming Soon!) and provides a large variety of easy to read graphs of system information. Observium..."
taxonomy_category:
  - "Scripts"
  - "Uncategorized"
taxonomy_post_tag:
  - "bash script"
  - "install script"
  - "observium"
  - "observium client"
  - "server health"
  - "server monitoring"
  - "shell script"
  - "snmp"
  - "snmp client"
  - "snmp daemon"
---

# Observium Client Setup Script

Written by

[nunim](https://www.sonicboxes.com/author/sbuser1/)

in

[Scripts](https://www.sonicboxes.com/category/bash-scripts/)
, [Uncategorized](https://www.sonicboxes.com/category/uncategorized/)

Observium is a neat PHP based system monitoring platform that I’ve been using lately, it’s fairly easy to install (Observium + Nginx/PHP-FPM install guide Coming Soon!) and provides a large variety of easy to read graphs of system information.

> Observium is an autodiscovering SNMP based network monitoring platform written in PHP which includes support for a wide range of network hardware and operating systems including Cisco, Windows, Linux, HP, Dell, FreeBSD, Juniper, Brocade, Netscaler, NetApp and many more.
> 
>  From the [Official Observium Wiki](http://www.observium.org/wiki/Main_Page)

After the initial task of Observium host installation and configuration, you need install and configure SNMP daemon on all of your client servers, aka all the servers that you want to monitor. This can be quite annoying if you’re monitoring more then a handful of servers, thus I have taken the time to write bash script for installation of the SNMP daemon on a client server.

**Script Usage:**

This script has been tested on **Debian 6/7, Ubuntu 12.04/13.10 and CentOS 5.10/6.5/7.0** – All other distributions are unsupported at this time.

```
wget www.sonicboxes.com/scripts/observium-client.sh
chmod 755 observium-client.sh
./observium-client.sh  <community>  <contact email>

EXAMPLE: 
[root@server ~]# ./observium-client.sh myservers obv@sonicboxes.com
Please enter where the server is physically located: New York
```

When you run the script, you need to define your community and your contact email. You will be prompted for the servers geographical location, enter the proper name of the city for Observium’s map to function correctly.

**SNMP Community:**  
 An SNMP community is essentially text string that functions as a password. It authenticates Observium to your client server and stops anyone else from being able to poll your SNMP daemon and receiving detailed information about the health of your system. Your community does not need to be unique for every server, you can use the same community for all of your servers, all servers in a specific geographical location, it’s entirely up to you.

**Adding a client to Observium:**  
 When you’ve finished installing the SNMP daemon on all of the servers you wish to monitor, it’s time to set them up in Obserivum. You’ll want to login to your Observium dashboard, hover your mouse over Devices, click Add Device.

[//www.sonicboxes.com/wp-content/uploads/2013/12/observium-addclient.png](//www.sonicboxes.com/wp-content/uploads/2013/12/observium-addclient.png)

For hostname enter the fully qualified domain name of the server you wish to monitor, it must be a domain you cannot use an IP address (**Note:** Observium does not support AAAA records), then enter the community you defined while installing the client. All other options may be left in their default setting, scroll down to the bottom of the page and click Add Device.

If it was successfully added you should see a green box with a check next to it that says something similar to this: Device added (id = 21). If you configured your cronjob properly, when you installed your Observium master, it will take about 5 minutes for your device to be polled and added to the map.

[//www.sonicboxes.com/wp-content/uploads/2013/12/observium-dashboard.png](//www.sonicboxes.com/wp-content/uploads/2013/12/observium-dashboard.png)
Observium dashboard showing server locations and status on a geographical map.Repeat these steps for every server you wish to monitor and soon you will have a nice map showing you the health of all of your servers.

[bash script](https://www.sonicboxes.com/tag/bash-script/)
 [install script](https://www.sonicboxes.com/tag/install-script/)
 [observium](https://www.sonicboxes.com/tag/observium/)
 [observium client](https://www.sonicboxes.com/tag/observium-client/)
 [server health](https://www.sonicboxes.com/tag/server-health/)
 [server monitoring](https://www.sonicboxes.com/tag/server-monitoring/)
 [shell script](https://www.sonicboxes.com/tag/shell-script/)
 [snmp](https://www.sonicboxes.com/tag/snmp/)
 [snmp client](https://www.sonicboxes.com/tag/snmp-client/)
 [snmp daemon](https://www.sonicboxes.com/tag/snmp-daemon/)

## Comments

### 14 responses to “Observium Client Setup Script”

1. [December 15, 2013](https://www.sonicboxes.com/observium-client-install-script/#comment-2) [Help with installation of Observium | WEB Server ip Reverse VPS hosting](http://server-ipreverse.rhcloud.com/low-end-talk/help-with-installation-of-observium-2) […] [http://www.sonicboxes.com/observium-client-setup-script/](http://www.sonicboxes.com/observium-client-setup-script/) […] [Reply](https://www.sonicboxes.com/observium-client-install-script/?replytocom=2#respond)
2. [April 12, 2014](https://www.sonicboxes.com/observium-client-install-script/#comment-144) Peter Why can’t you use an IP address instead of domain name? If fully qualified name is required can the IP mapping be defined in hosts file? [Reply](https://www.sonicboxes.com/observium-client-install-script/?replytocom=144#respond)
  1. [April 12, 2014](https://www.sonicboxes.com/observium-client-install-script/#comment-145) nunim It *should* work just fine if you define it in the HOSTS file. Taken from the [Observium FAQ](http://www.observium.org/wiki/FAQs#Why_can.27t_I_add_my_device_by_its_IP_address.3F_.2F_Why_do_I_need_valid_hostnames_and_DNS.3F) : Because parts of the auto-discovery code and protocol relationship tracking code requires valid hostnames. We made an early architectural decision to make this name the primary identification for a host. I would really like to see proper support for AAAA records, it’s just good practice to have a FQDN as your hostname. [Reply](https://www.sonicboxes.com/observium-client-install-script/?replytocom=145#respond)

3. [December 14, 2014](https://www.sonicboxes.com/observium-client-install-script/#comment-5963) [Kris](http://lowendtalk.com) Works great, linked to this for CloudCommando. Thanks nunim! [Reply](https://www.sonicboxes.com/observium-client-install-script/?replytocom=5963#respond)
4. [January 17, 2015](https://www.sonicboxes.com/observium-client-install-script/#comment-7876) Joel I’m getting “./observium-client.sh: line 69: /bin/systemctl: No such file or directory” when trying to run the script. SNMP installed fine. CentOS 6.6 64bit. [Reply](https://www.sonicboxes.com/observium-client-install-script/?replytocom=7876#respond)
  1. [January 19, 2015](https://www.sonicboxes.com/observium-client-install-script/#comment-7890) nunim This is normal on CentOS 6, I’ve added that line to ensure compatibility with CentOS 7, haven’t gone back in to add a check for 6 vs. 7 yet. [Reply](https://www.sonicboxes.com/observium-client-install-script/?replytocom=7890#respond)

5. [January 25, 2015](https://www.sonicboxes.com/observium-client-install-script/#comment-7944) Berkay It seems that [http://www.observium.org/svn/observer/trunk/scripts/distro](http://www.observium.org/svn/observer/trunk/scripts/distro) is no longer available. An identical file is stored at [https://raw.githubusercontent.com/tomzx/observium/svn-trunk/scripts/distro](https://raw.githubusercontent.com/tomzx/observium/svn-trunk/scripts/distro) and you might want to change it to that. [Reply](https://www.sonicboxes.com/observium-client-install-script/?replytocom=7944#respond)
  1. [January 29, 2015](https://www.sonicboxes.com/observium-client-install-script/#comment-7982) nunim Thanks for the heads-up, I’ve made the necessary adjustments to the install script. [Reply](https://www.sonicboxes.com/observium-client-install-script/?replytocom=7982#respond)
    1. [February 3, 2015](https://www.sonicboxes.com/observium-client-install-script/#comment-8028) Berkay You’re welcome, and thank’s for the script. [Reply](https://www.sonicboxes.com/observium-client-install-script/?replytocom=8028#respond)

6. [November 8, 2015](https://www.sonicboxes.com/observium-client-install-script/#comment-9284) Eduardo Thanks for sharing. [Reply](https://www.sonicboxes.com/observium-client-install-script/?replytocom=9284#respond)
7. [June 28, 2016](https://www.sonicboxes.com/observium-client-install-script/#comment-10177) Victor syntax error near unexpected element `newline ‘ [Reply](https://www.sonicboxes.com/observium-client-install-script/?replytocom=10177#respond)
  1. [September 8, 2016](https://www.sonicboxes.com/observium-client-install-script/#comment-10322) nunim Victor, You’ll need to provide some more context in regards to where you’re seeing this error, along with OS & Version. [Reply](https://www.sonicboxes.com/observium-client-install-script/?replytocom=10322#respond)

8. [September 12, 2016](https://www.sonicboxes.com/observium-client-install-script/#comment-10331) Max Hiya, Had no problem before the summer using/downloading the script. Looks to me some change has been made to the certificate on the site. Connecting to [http://www.sonicboxes.com](http://www.sonicboxes.com) |104.251.216.12|:443… connected. ERROR: cannot verify [http://www.sonicboxes.com](http://www.sonicboxes.com) ‘s certificate, issued by `/C=BE/O=Global Sign nv-sa/CN=AlphaSSL CA – SHA256 – G2′: Issued certificate has expired. ERROR: certificate common name `*.sonicboxes.net’ doesn’t match requested host name ‘www.sonicboxes.com’. To connect to [http://www.sonicboxes.com](http://www.sonicboxes.com) insecurely, use `–no-check-certificate’. Unable to establish SSL connection. CentOS 5-7 does not seem to like LetsEncrypt. [Reply](https://www.sonicboxes.com/observium-client-install-script/?replytocom=10331#respond)
  1. [January 5, 2017](https://www.sonicboxes.com/observium-client-install-script/#comment-10515) nunim It was most likely just an issue with the SSL cert on my end being configured incorrect. I’ve resolved the issue and it should be functioning normally. [Reply](https://www.sonicboxes.com/observium-client-install-script/?replytocom=10515#respond)

### Leave a Reply [Cancel reply](/observium-client-install-script/#respond)

## More posts

- ### [KASM SSL](https://www.sonicboxes.com/kasm-ssl/) [April 19, 2026](https://www.sonicboxes.com/kasm-ssl/)
- ### [How to Set Up Deluge with Nginx on a VPS for a Seedbox – Part 1](https://www.sonicboxes.com/585-2/) [November 17, 2025](https://www.sonicboxes.com/585-2/)
- ### [How to Set Up Deluge with Nginx on a VPS for a Seedbox](https://www.sonicboxes.com/how-to-set-up-deluge-with-nginx-on-a-vps-for-a-seedbox/) [November 13, 2025](https://www.sonicboxes.com/how-to-set-up-deluge-with-nginx-on-a-vps-for-a-seedbox/)
- ### [Using a Cheap USB GPS Module (VK-162) with Python](https://www.sonicboxes.com/using-a-cheap-usb-gps-module-vk-162-with-python/) [September 16, 2025](https://www.sonicboxes.com/using-a-cheap-usb-gps-module-vk-162-with-python/)
