Monitor installation

The Monitor is composed by a java servlet configured by a JOOMLA component. In this section, we are going to show how to deploy the servlet and configure it to point on the JOOMLA installation.

Conventions:

  • {Tomcat} : Path to where is installed Tomcat.
  • {Monitor} : Path to where is installed Monitor (default : {Tomcat}\webapps\Monitor)
  • {Server} : Tomcat's server name and port if required (for instance : localhost:8080)

Deploying the application

  1. Copy the war file into {Tomcat}\webapps.
  2. If Tomcat is down, start it up.
  3. The application should be self extracted after a few seconds. If it is not the case, please restart Tomcat or take a coffee break.

Database setup

You need to configure the application to connect properly to your database:

  1. Open the {Monitor}\WEB-INF\monitor-config.properties file.
  2. Modify, if required, the followings parameters:
    jdbc.driver : Path to the Java JDBC driver. Must be in classpath.
    jdbc.url : JDBC URL to your Joomla+easySDI database. Must end with your schema or catalog name. Example : jdbc.url=jdbc:mysql://localhost/joomla3
    jdbc.username : User name.
    jdbc.password : Password.
  3. Choose the appropriate dialect for the property hibernate.dialect and indicate one of the followings dialect:
    MySQL (all vers.) : org.hibernate.dialect.MySQLDialect
    MySQL 5 : with InnoDB org.hibernate.dialect.MySQL5InnoDBDialect
    MySQL : with InnoDB org.hibernate.dialect.MySQLInnoDBDialect
    MySQL : with MyISAM org.hibernate.dialect.MySQLMyISAMDialect
  1. Open the {Monitor}\WEB-INF\classes\Email.properties file and modify, if required, the parameters to match your smtp host; this feature is required because EasySDI Monitor sends alerts via e-mail
  2. Open the {Monitor}\WEB-INF\classes\image-config.properties file and set the folder pathes (local and url) to somewhere in the PHP server for saving the images into (remember to give write access), for example:
    - imagefolderLocal=C:\\xampp\\htdocs\\monitor\\img\\
    - imageFolderUrlPath=http://localhost/monitor/img/
  3. Optional: Some actions (delete jobs, get a private job, ...) require an admin authentication. The credentials are stored into the "users" database table. The default credentials are: user:Admin pwd:adm. Feel free to set another one.

Note : you can also install monitor on another database. To do this you need to: setup a new database, create Monitor tables (last section in the easySDI SQL install script found in com_easysdi_core/administrator/sql/install/mysql/install.sql), then change the JDBC URL, user and password.

Test your server side installation

Enter into your web browser the following address: http://{Server}/Monitor/jobs. You should receive a JSON text with an empty data[] collection[]. In case of error, please search the forum first or post a new thread.

You will need to configure your JOOMLA component to point on this service.

Known issues

If Tomcat crashes and logs a PermGenSpace problem, change your JAVA_OPTS for Tomcat as :
JAVA_OPTS="-Djava.awt.headless=true -Dfile.encoding=UTF-8 -server -Xms512m -Xmx1024m -XX:NewSize=256m -XX:MaxNewSize=256m -XX:PermSize=256m -XX:MaxPermSize=256m -XX:+DisableExplicitGC"