What is JENNIFER Data Server?

Data server is a server that not only fulfills the function of managing agents between the JENNIFER agent and the view server, but also processes data as well as delivers data requested from the view server.

Download and unzip JENNIFER 5 package, and then the server.data directory is created. This folder is JENNIFER data server.

Control of Data Server Agent

Data server opens a port and stands by for access by the agent. When the agent accesses the applicable port, the data server identifies the status of the agent connection and the validity of the agent license.

Data Processing by Data Server

Data server performs processing, storage and search of all data collected and transmitted by the agent.

Specifications of JENNIFER Data Server

Although the specifications of JENNIFER data server vary depending on the scale of the monitoring target system and the volume of data to be collected, generally the minimum requirements for the data server that provides service for transactions of 1000TPS or below are as follows.

Configuration of JENNIFER Data Server Directories

The configuration of JENNIFER data server directories is as follows.

Start and Stop JENNIFER Data Server on UNIX System

Configure JENNIFER Data Server

Data server is a server that not only performs the function of managing agents between the JENNIFER agent and the view server, but also processes data as well as delivers data requested from the view server. Data server can be expanded when the volume of data to collect is big or the number of agents is large.

Configuration Required When Starting the Data Server

${JENNIFER_DATA_SERVER_HOME}/bin/jennifer_data.sh file contains the required configuration to start the data server in the UNIX environment. This file contains JAVA_HOME, data server home, server configuration file and data server JVM options. You can configure the server using the variables listed below according to the environment in which JENNIFER is installed.

# ----------------------------------------------------------------------
# ----- Customizable Variables -----------------------------------------
# ----------------------------------------------------------------------
JAVA_HOME=/home/jennifer/jdk1.8.0_31
JENNIFER_DATA_SERVER_HOME=/home/jennifer5/server.data
JENNIFER_DATA_SERVER_CONF=${JENNIFER_DATA_SERVER_HOME}/conf/server_data.conf
JENNIFER_DATA_SERVER_LOG_CONF=${JENNIFER_DATA_SERVER_HOME}/conf/logback.xml

Configure Data Server Options

This is a configuration file that contains the basic settings for the data server, such as where to store data or how to configure the port. By default, the file is located in conf/server_data.conf in the data server home directory, but the file name and location can be changed in the configuration. Values that must be basically configured for server_data.conf are listed below.

db_path=../db_data
listen_port=5000

Start JENNIFER Data Server

1. Move to the bin directory in the data server.

cd /home/jennifer5/server.data/bin

2. In the bin directory, run startup_data.sh.

#
# ./startup_data.sh
#

3. Check whether the data server is started properly. When properly started, you can see the following log.

2014-11-28 10:22:38.548 [main] INFO  com.jennifersoft.data.Main - Using JRE: /home/jennifer/jdk1.8.0_31/jre
2014-11-28 10:22:38.553 [main] INFO  com.jennifersoft.data.Main - Jennifer data server home: /home/jennifer5/server.data
2014-11-28 10:22:38.559 [main] INFO  com.jennifersoft.data.Configure - Load configuration: /home/jennifer5/server.data/conf/server_data.conf
2014-11-28 10:22:38.563 [main] INFO  com.jennifersoft.data.Main - Database path: /home/jennifer5/server.data/db_data
2014-11-28 10:22:38.563 [main] INFO  com.jennifersoft.data.Main - Data server version: 5.0.5
2014-11-28 10:22:38.564 [main] INFO  com.jennifersoft.data.Main - System property: user.timezone=Asia/Seoul,file.encoding=UTF-8
2014-11-28 10:22:38.589 [Global Timer:Running:com.jennifersoft.data.mng.DomainListLogger$1] INFO  c.j.data.mng.DomainListLogger$1 - Available domain: None
2014-11-28 10:22:38.625 [main] INFO  com.jennifersoft.data.Main$2 - Data server startup. address=/0:0:0:0:0:0:0:0, port=5000

4. When the view server is connected, the following log is created.

2014-03-03 18:01:52.098 [RECEIVE_EXECUTOR thread - 7] INFO c.j.net.worker.ReceiveWorker - View server is connected: address=127.0.0.1

5. When the agent is connected, the following log is created.

2014-03-03 18:09:05.166 INFO Agent is connected: sid=1000, instance id=1, session id=2, address=192.168.0.139, version=1.0.0
2014-03-03 18:09:05.323 INFO Agent information is updated: sid=1000, instance id= 1, license: VALID

Stop JENNIFER Data Server

1. Move to the bin directory in the data server.

cd /home/jennifer5/server.data/bin

2. In the bin directory, run jennifer_data.sh. Input 'stop' as a value for the factor.

#
# ./shutdown_data.sh
#

3. When the data server is properly stopped, the following log is displayed.

2014-11-28 10:34:46 AM.310 [main] INFO com.jennifersoft.data.Main - Using JRE: /home/jennifer/jdk1.8.0_31/jre
2014-11-28 10:34:46 AM.312 [main] INFO com.jennifersoft.data.Main - Jennifer data server home: /home/jennifer5/server.data
2014-11-28 10:34:46 AM.319 [main] INFO com.jennifersoft.data.Configure - Load configuration: /home/jennifer5/server.data/conf/server_data.conf
2014-11-28 10:34:46 AM.322 [main] INFO com.jennifersoft.data.Main - Database path: /home/jennifer5/server.data/db_data
2014-11-28 10:34:46.717 [main] INFO com.jennifersoft.data.Main - Shutting down...
2014-11-28 10:34:46.722 [main] INFO com.jennifersoft.data.Main - Shutdown is done

Start and Stop JENNIFER Data Server in Windows System

Configure JENNIFER Data Server

The data server is a server that not only performs the function of managing agents between the JENNIFER agent and the view server, but processes data as well as delivers data requested from the view server. Data server can be expanded when the volume of data to collect is big or the number of agents is large.

Data Server Configuration

%JENNIFER_DATA_SERVER_HOME%bin\jennifer_data.bat file contains the configuration required for starting JENNIFER data server. This file contains JAVA_HOME, data server home, server configuration file and data server JVM options. Depending on the environment in which JENNIFER is installed, you can configure the server using the variables listed below.

rem ----------------------------------------------------------------------
rem ----- Customizable Variables -----------------------------------------
rem ----------------------------------------------------------------------
set JAVA_HOME=c:\jdk18
set JENNIFER_DATA_SERVER_HOME=C:\work\jennifer5\server.data
set JENNIFER_DATA_SERVER_CONF=%JENNIFER_DATA_SERVER_HOME%\conf\server_data.conf
set JENNIFER_DATA_SERVER_LOG_CONF=%JENNIFER_DATA_SERVER_HOME%\conf\logback.xml
rem ----------------------------------------------------------------------

Configure Data Server Options

This is a configuration file that contains the basic settings for the data server, such as where to store data or how to configure the port. By default, the file is located in conf/server_data.conf in the data server home directory, though you can change the file name and location in the configuration. Values that must be configured for server_data.conf are listed below.

db_path=../db_data
listen_port=5000

Start JENNIFER Data Server

1. Move to the bin directory in the data server.

C:\work\jennifer5\server.data

2. In the bin directory, run startup_data.bat.

C:\work\jennifer5\server.data\bin>startup_data.bat

3. Check whether the data server is properly started. When it has properly started, you can see the following log.

2014-07-21 11:49:45.900 [main] INFO  com.jennifersoft.data.Main - Using JRE: c:\jdk18\jre
2014-07-21 11:49:45.900 [main] INFO  com.jennifersoft.data.Main - Jennifer data server home: C:\work\jennifer5\server.data
2014-07-21 11:49:45.947 [main] INFO  com.jennifersoft.data.Configure - Load configuration: C:\work\jennifer5\server.data\conf\server_data.conf
2014-07-21 11:49:45.963 [main] INFO  com.jennifersoft.data.Main - Database path: C:\work\jennifer5\server.data\db_data
2014-07-21 11:49:45.979 [main] INFO  com.jennifersoft.data.Main - Data server version: 5.0.1
2014-07-21 11:49:45.979 [main] INFO  com.jennifersoft.data.Main - System property: user.timezone=Asia/Seoul,file.encoding=MS949
2014-07-21 11:49:46.057 [Data Server thread - 1] INFO  com.jennifersoft.data.Main - Jennifer5 data server startup. address=/0.0.0.0:5000, port=5000
2014-07-21 11:49:46.104 [Global Timer:Running:com.jennifersoft.data.mng.DomainListLogger$1] INFO  c.j.data.mng.DomainListLogger$1 - Available domain: None

4. When the view server is connected, the following log is created.

2014-03-07 11:11:02.506 [RECEIVE_EXECUTOR thread - 8] INFO c.j.net.worker.ReceiveWorker - View server is connected: address=127.0.0.1, version=1.0.0

5. When the agent is connected, the following log is created.

2014-03-07 10:31:51.464 [RECEIVE_EXECUTOR thread - 7] INFO c.j.net.worker.ReceiveWorker - Agent is connected: sid=1000, instance id=1, session id=1, address=127.0.0.1, version=1.0.0
2014-03-07 10:31:51.604 [RECEIVE_EXECUTOR thread - 8] INFO c.j.net.worker.ReceiveWorker - Agent information is updated: sid=1000, instance id= 1, license: INVALID

Register JENNIFER Data Server as a Windows Service

1. Open a cdm.exe window as an administrator.

2. In the server.data\bin directory, run reg_service.bat.

The default value of a service name to be registered is "jennifer_data". If you want to change this value, you are required to create the following INI file in the same folder before running reg_service.bat.

jenniferdata64.ini

Following shows the content of an INI file having the same value as the default value.

[default]
serviceName=jennifer_data
servicePath=jennifer_data.bat

Stop JENNIFER Data Server

1. Move to the bin directory in the data server.

C:\work\jennifer5\server.data

2. In the bin directory, run shutdown_data.bat.

C:\work\jennifer5\server.data\bin> shutdown_data.bat

3. When the data server has properly stopped, the following log is displayed.

2014-03-07 11:14:37.901 [main] INFO com.jennifersoft.data.Main - Using JRE: C:\jdk\jdk18\jre
2014-03-07 11:14:37.934 [main] INFO com.jennifersoft.data.Main - Jennifer data server home: C:\work\jennifer5\server.data
2014-03-07 11:14:37.952 [main] INFO com.jennifersoft.data.Configure - Configuration file: C:\work\jennifer5\server.data\conf\server_data.conf
2014-03-07 11:14:37.970 [main] INFO com.jennifersoft.data.Configure - Database path: C:\work\jennifer5\server.data\db
2014-03-07 11:14:37.975 [Thread-0] INFO com.jennifersoft.data.Main$2 - Shutting down...
2014-03-07 11:14:37.991 [Thread-0] INFO com.jennifersoft.data.Main$2 - Shutdown is done
2014-03-07 11:14:38.804 [Thread-0] INFO com.jennifersoft.data.Main$2 - Shutting down...
2014-03-07 11:14:38.817 [Thread-0] INFO com.jennifersoft.data.Main$2 - Shutdown is done