A mongobird can be performed on any OS which run JVM. It will take a lot of space for monitoring data files; consideration should be given to the size of resource files that will occupy the MongoDB and Graph data directory. So you make sure that there is enough hard disk space, and install. For detailed system requirements are as follows.
System Requirements
[/vc_column_text]
| CPU | 2 GHz Dual-Core or higher | |
| RAM | 2GB | |
| HDD | 50GB available in hard disk | |
| JDK | 1.6.0 or higher |
Auto Installation
We provide a shell script for automatic installation of the downloaded package. By entering the appropriate information in the question of the shell script, you will be able to complete the installation easily. This install shell script tested in CentOS 6.x 64 bit machine.
 |
|||
Create any folder for download package file – ‘mongobird_inst.tgz’ and copy ‘mongobird.tgz’ file to your created folder. When copy is complete, extract the file and execute a shell script file – ‘mongobird_inst.sh’.
|
|||
 |
|
| In order to install the mongobird, you must install JDK, Tomcat and MongoDB. Installation of these packages is performed as follows. | |
To reduce the size of the installation file, we did not include below files in mongobird’s install package. In order to automatically install, you must download below files and copy to the correct path. |
| 1) Dwonload JDK | |||
Installation file of the JDK can be downloaded from Oracle. A mongobird was developed base on Java 6 update 35. So, we are recommended to install jdk 6u36 or higher. Please note, you must select the normal bin file not rpm version when you select file to download. When the download is complete, copy the downloaded jdk file to the folder ‘jdkinst’ included in the files extracted from the mongobird_inst.tgz file.
|
| 2) Download Tomcat | |||
Installation file of the Tomcat can be downloaded from Apache Tomcat. A mongobird is a web-based system for monitoring MongoDB which uses Tomcat Web Server. We are recommended to install Apache Tomcat 6.0.35 or higher. For example, the name of the file to download is ‘apache-tomcat-6.0.35.tar.gz’. When the download is complete, copy the downloaded tomcat file to the folder ‘tomcatinst’ included in the files extracted from the mongobird_inst.tgz file. Be careful not to extract file that you downloaded.
|
| 3) Download MongoDB | |||
A mongobird uses MongoDB to save the data of state which is transmitted from the MongoDB that you are monitoring. We are recommended to install MongoDB 2.2 or higher. As in the previous case, the installation file of MongoDB is a compressed file type. For example, the name of the file to download is ‘mongodb-linux-x86_64-2.2.0.tgz’. When the download is complete, copy the downloaded MongoDB file to the folder ‘mongoinst’ included in the files extracted from the mongobird_inst.tgz file. Be careful not to extract file that you downloaded.
|
 |
|||
When the copy is completed in a subfolder of each file of all three, run the installation script.
|
|||
Manual Installation
In this section, you will learn how to install manually without using the script shell. Because mongobird is a web service that developed in JAVA, it needs JDK and Tomcat. In addition, it also needs MongoDB for storing status data.
| |
||||||||||
You need to install required software – JDK, Tomcat and MongoDB – before you install mongobird. These software install by referring to the below list.
|
||||||||||
| |
|
| If the previous software has been successfully installed, after stopping the Tomcat service, you will deploy a war file to Tomcat. The war file – tetrad.war – can be found when you extract a mongobird’s file that you downloaded. | |
| |
|||
A mongobird uses the RRD engine for various graph ouput. So, you need to create a folder that RRD uses. Create folders as follows – you can also change the directories to another location.
|
|||
 |
|||
Register to environment variable to folders that you created in Step3. A location of the environment variable is as follows.${tomcatWebappsPath}/tetrad/WEB-INF/classes/tetrad_rrd.propertiesOpen the above file and then modify the contents of the following.
|
|||
 |
|||
After you complete the configuration of RRD environment in Step 4, you will register the configuration of MongoDB. A location of the environment variable is as follows.${tomcatWebappsPath}/tetrad/WEB-INF/classes/monad.propertiesOpen the above file and then modify the contents of the following.
If MongoDB is separately installed, then you should be reconfigured with the address and port number of MongoDB. |
|||
 |
|||||||
After you complete the configuration of MongoDB environment in Step 5, restart Tomcat service and connect mongobird as follows.
|
|||||||
If you have a previous version installed on the computer where you want to install mongobird, you can install the upgrade of mongobird. Upgrade installation is done by hand but not provide an automatic script.
| |
|
| Most of the upgrade process is safe, but we recommended that you backup your mongobird’s data because an error may occur during the upgrade. Your backup data are RRD graphics files and database files of MongoDB. | |
| 1) Stop tomcat and MongoDB | |||
Stop tomcat and MongoDB services using below command.
|
| 2) Backup MongoDB | |||
Backup the database file of MongoDB by using mongodump. The database name to be backup is ‘monad’. If MongoDB is separately installed, then you should be reconfigured with the address and port number of MongoDB.
|
| 3) Backup Graphs | |||
Backup the graph files of RRD. Proceed as follows.
|
| |
|||
After stopping the Tomcat service and backup, you will deploy a war file to Tomcat for new mongobird. The war file – tetrad.war – can be found when you extract a mongobird’s file that you downloaded. After updating the war file, restart Tomcat and MongoDB services, and check mongobird.
|
|||
| |
|
| If mongobird does not run normally in Step 2, install a new mongobird that you downloaded after remove old mongobrid. | |
| 1) Stop Tomcat and MongoDB | |||
Stop Tomcat and MongoDB services using below command.
|
| 2) Uninstall old mongobird | |||
How to uninstall mongobird is simple. It is performed by removing the contents of the folder that is installed. Folders to be removed are as follows. Be careful, the folder name in the following depends on the installed version.
|
| 3) Install new mongobird | |
| Reinstall new mongobird by referring to the first installation. |
| 4) Restore database. | |||
The backup database file using mongodump is restored as follows by using the command – mongorestore. If MongoDB is separately installed, then you should be reconfigured with the address and port number of MongoDB.
|
| 5) Restore rrd files. | |||
Copy the backup files to restore it as follows.
|
| 6) Run mongobird. | |||||||
In order to confirm that it has been successfully restored, restart Tomcat service and connect mongobird as follows. If mongobird does not work normally, perform again step 3.
|