MFM 4 - EXEM€¦ · 1 minute Create Procedure and Tables Click the ‘Create Repository DDL’...

MFM 4.2 Install Guide

Table of contents

1.System diagram ........................................................................................................................................................................ 4

2. MaxGauge For MySQL Install Information ................................................................................................................. 6

Install file information ...................................................................................................................................................... 6

Port information ................................................................................................................................................................. 6

Main Directory ..................................................................................................................................................................... 6

Software Start/End ............................................................................................................................................................. 7

Start ................................................................................................................................................................................. 7

Stop ................................................................................................................................................................................. 7

3. MaxGauge for MySQL Installation ................................................................................................................................. 9

Pre-installation Preparations ......................................................................................................................................... 9

MaxGauge for MySQL Installation Procedure ...................................................................................................... 9

Monitoring Server .................................................................................................................................................... 9

Logging Server ........................................................................................................................................................ 19

Window version ...................................................................................................................................................... 20

Linux Version ............................................................................................................................................................ 31

3

SYSTEM

DIAGRAM

1

MFM 4.1_INSTALL GUIDE

4

1.System diagram

MAXGAUGE FOR MYSQL INSTALL INFORMATION

5

MAXGAUGE FOR MYSQL

INSTALL INFORMATION

2

2. Maxgauge For MySQL Install Information ................................................................................................................. 6

Install file information ...................................................................................................................................................... 6

Port information ................................................................................................................................................................. 6

Main Directory ..................................................................................................................................................................... 6

Software Start/End ............................................................................................................................................................. 7

Start ................................................................................................................................................................................. 7

Stop ................................................................................................................................................................................. 7


6

2. MaxGauge for MySQL Install Information

Install file information File Name Install Location

sysmon.maxgauge4mysql_20151202_sysmon_64bit.linux.tar Monitoring Server

maxgauge4mysql.v4.2.151207.1822.install.WIN.zip Logging Server

license.TRIAL_20160630.mfm.key Logging Server

Port information Host Default Port Description

Real-time Monitor

Communication

8070 Communication port between WAS/GAHTER and the Client

MySQL DB

Communication

3306 Communication port between MySQL DB and

WAS/GATHER

Daemon

Communication

9729 Communication port between Daemon and WAS/GATHER

Main Directory Directory Description Install

Location

Install Path/maxgauge/sysmon MaxGauge Daemon Install Path Monitoring

Server

Install Path/maxgauge/sysmon/conf/instance01 MaxGauge Daemon Settings File Path Monitoring

Server

Install Path\maxgauge4mysql.v4.2.151207 MaxGauge WAS/GAHTER Settings Path Logging Server

MAXGAUGE FOR MYSQL INSTALL INFORMATION

7

Software Start/End

Start

Command or Button Results Check Install Location

./sysmonlinux -d Ps –ef | grep sysmon Monitoring Server

./sysmonlinuObserver -d Ps –ef | grep sysmon Monitoring Server

Was start Program Check OK Logging Server

Controller start Program Check OK Logging Server

Stop

Command or Button Results Check Install Location

Kill -9 SID Name Ps –ef | grep sysmon Monitoring Server

Was stop Program Check OK Logging Server

Controller stop Program Check OK Logging Server


8

MAXGAUGE FOR MYSQL

INSTALLATION

3

3. MaxGauge for MySQL Installation ................................................................................................................................. 9

Pre-installation Preparations ......................................................................................................................................... 9

MaxGauge for MySQL Installation Procedure ....................................................................................................... 9

Monitoring Server ..................................................................................................................................................... 9

Logging Server ........................................................................................................................................................ 19

Window version ...................................................................................................................................................... 20

Linux Version .......................................................................................................................................................... 311

MAXGAUGE FOR MYSQL INSTALLAION

9

3. MaxGauge for MySQL Installation

Pre-installation Preparations

Job Name Job Description

DB Server

▪ Port Preparation : 9729 (Sysmon Communication Port)

▪ DB Account : Maxgauge Data Collection DB Account Required.

(Grant rights to select all tables)

▪ Process Confirmation Request: MySQL Error, Slowquery Log Path

Confirmation Request

Logging PC

(Repository DB)

▪ Port Preparation : 8070 (WAS Driver Port / Web Server Connection)

8071 (WAS Stop Port) -Local Communications

8072 (Gather) -Local Communications

3306 (Monitoring Server Connection Port)

▪ DB Account : Official Versions after MYSQL 5.6

Database, Table, Function, Procedure, View, and etc.

Mostly Crud rights.

MaxGauge for MySQL Installation Procedure

Monitoring Server

Job Name Job Description Time

Duration

Upload Install File Upload 3 minutes

Create Directory Create Install Path’s Directory for MaxGauge 1 minute

Unzip Files Unzip files (Tar) 1 minute

Daemon Execution File execution to create environment configuration

file. 2 minutes

Mysqld Path Check MySQL Path Check

Check with ps-ef | grep mysqld 3 minutes


10

Error log, data directory

slow query Path Check Check from ps –ef | grep mysqld 3 minutes

Port Check netstat –an | grep 9729 Port Check 1 minute

Environment

Configuration

Enter the relevant information in the files

/maxgauge/sysmon/conf/instance01

/maxgauge/sysmon/conf/mfm.conf

3 minutes

Daemon Start ./maxgauge/sysmon/bin/sysmonlinuxObserver –d

Install File Upload

sysmon.maxgauge4mysql_20151202_sysmon_64bit.linux.tar File Upload

Upload file in the install location

Create Directory to unzip Files

Create Maxgauge For Mysql directory in the desired install location by the administrator.

Default : Directory location for installation/ maxgauge/ sysmon

Create maxgauge directory in the desired install location by the administrator.

mkdir maxgauge

Create sysmon directory inside the maxgauge directory.

cd maxgauge

mkdir sysmon

Create bin, tmp directory inside the sysmon directory.

cd sysmon

mkdir bin

mkdir tmp


11

Move the upload files into the install path /maxgauge/sysmon/bin-directory, and

unzip files.

Move the uploaded files to Install Path/maxgauge/ sysmon/bin/

mv sysmon.maxgauge4mysql_20151202_sysmon_64bit.linux.tar Install Path/maxgauge/sysmon/bin/

▪Unzip

tar-xvf sysmon.maxgauge4mysql_20151202_sysmon_64bit.linux.tar


12

Move the zip files to the directory maxgauge/ sysmon/tmp which was created in 2)

above.

Move the zip files to tmp location created in 2) so that version can be checked afterwards.

mv sysmon.maxgauge4mysql_20151202_sysmon_64bit.linux.tar Install Location/maxgauge/sysmon/tmp

Or

mv sysmon.maxgauge4mysql_20151202_sysmon_64bit.linux.tar ../tmp

To create environment configuration file, run sysmonlinux in the sysmon/bin folder and then quit

Go to Install Location/maxgauge/sysmon/bin

cd Install Location/maxgauge/sysmon/bin

Start sysmon daemon to create environment configuration file.

./sysmonlinux –d

Go to Install Location/maxgauge/sysmon and check whether the conf, log directories have been created.

cd Install Location/maxgauge/sysmon/


13

Deamon kill

Kill because it is a daemon (sysmon) which has not created an environment configuration.

Check sysmon’s SID value

ps –ef | grep sysmon

▪kill

kill -9 SID Name

▪ Check if it has been terminated successfully.



14

Port Check

Sysmon Communication Port Check

nestat –an |grep 9729

Mysqld path and port check

Check MySQL environment configuration values and the port

ps –ef| grep mysqld

Copy the corresponding path

Identify error log/ data directory / slow query path

Check log error location in Mysql environment configuration values

ps –ef | grep mysqld

▪Check Log Error location


15

▪Check Data directory location

Enter relevant MySQL environment path in the install location/ maxgauge/ sysmon/

conf/ instance01

Go to Install Location/maxgauge/sysmon/conf

cd Install Location/maxgauge/sysmon/conf

▪Enter corresponding path in instance01

vi instance01

Instance 01

▪ PORT : Enter MySQL Port

▪ PATH : Enter MySQL Path (In case you do not find the corresponding MySQL with the PORT above, use

PATH to connect.)

▪ DATA_PATH : Enter Data Path (ps -ef |grep mysqld’s data dir)

▪ ERROR : Enter ERROR LOG Path (ps –ef | grep mysqld’s log-error)

▪ SLOWQUERY : Enter SLOWQUERY Path (Check the corresponding path and enter.)


16

Enter Port in Install Loction /maxgauge/ sysmon/ conf/ mfm.conf

Enter Sysmon communication port in the mfm.conf

vi mfm.conf

Run mfm.conf values in Default status.

mfm.conf

▪ PORT : Enter Sysmon Port

▪ LEVEL : Consol (Screen Output):0, Packet:1(Request Response log file storage), Process:2(Collection Data

log file storage)

▪ INTERVAL : Log transmission check cycle (seconds)

▪ LIMIT_MEM : Collection limit memory (MB) – When each log exceeds the limit, the existing collected log will

be deleted.

▪ LIMIT_TRANS : Size Limit Per Transmission (KB) – May vary depending on the network situation.

▪ FILES : Enter SysLog Path

▪ ALIAS : Instance nickname and separate by ; when entering.

When there are several MySQLs in a server, then enter more names.


17

Debug File

Rename Debug file

mv readme.log.conf log.conf

Move Debug file

mv log.conf Install Path/maxgauge/sysmon/conf/

or

mv log.conf ../conf


18

Daemon Activation

Go to Install Location/maxgauge/sysmon/bin

cd Install Location/maxgauge/sysmon/bin

Activate sysmon Observer

/sysmonlinuxObserver –d

Once the sysmon Observer is activated, sysmon daemon is automatically activated.

▪Check whether it has been activated successfully.



19

Logging Server

Job Name Job Description Time Duration

Upload Install File Upload 3 minutes

Create Directory Create intall path’s directory for

Maxgauge. 1 minute

Unzip Files Unzip files. (TAR or ZIP) 1 minute

License Registration License registration 2 minutes

Agent Execution Agent (Was, Gather

Configuration File) Execution 3 minutes

Environment Configuration

Enter Logging pc MySQL

information

Enter WAS, Gather Port

(default : 8070 8071)

Enter Create DB name for

Maxgauge

Enter MySQL login account for

Maxgauge

5 minutes

Connection Success Test Click the ‘Connect test’ button

and confirm success. 1 minute

Create Procedure and Tables

Click the ‘Create Repository DDL’

button, and the required

procedure and tables will be

automatically created.

2 minutes

ent Activation Execute Menu>Process > All

Start. 1 minute


20

Window version

Create Directory

Create Directory for Maxgauge in the install location.

Install file upload

Upload the file maxgauge4mysql.v4.2.151207.1822.install.WIN

Upload the file in the install location


21

Unzip File

Unzip the file maxgauge4mysql.v4.2.151207.1822.install.WIN

Check to make sure the unzipped folder contains the app, bin, biz, conf, svc, execution file

(MaxGauge4MySQLWeb.exe).


22

Insert license

Go to the license folder inside the conf folder.

Upload the license file in the corresponding location.


23

MaxGauge4mysqlWeb.exe.Execution

Execute Execution File (MaxGauge4MySQLWeb.exe)

.


24

Environment configuration

Enter Configuration’s Logging PC Environment Variables

▪Process - WAS

Listen Port : WAS Start Port / Web Connection (Default : 8070)

Stop Port : WAS Stop Port (Default : 8071)

Process – Gather

Listen Port : Gather Start (Default : 8072)

Database -Repository

Type : Select DB Type

Hostname : Enter Logging PC’s IP

DB Name : Logging PC MySQL’s DB Name for Maxgauge Data Collection

Once name is assigned, use the name you will enter in step 6) below to create DB and apply procedure.

( ex : MFM150413)

User : Logging PC MySQL’s Login account

Password : Logging PC MySQL’s Login Password

If the next screen appears

by default, then it is

Normal.


25

Check the connection to Logging PC’s MySQL.

Click the ‘connect test’ button at the bottom.

If ‘Success’, then OK.

Create DB and Procedure for MaxGauge in Logging PC’s MySQL

Click the ‘Create Repository DDL’ button at the bottom.

▪Once you click the button, the Cmd window will automatically open.

Enter Logging DB’s IP

(ex)192.168.123.160

Enter the

desired DB

name

When necessary,

select MariaDB


26

Once creating DB and Procedure has been automatically processed, if the last ‘Success’ appears, it is normal.

WAS, GATHER Execution

▪ Click the Save button to save the changes.

▪ From the Menu window, click Process > All start.

When starting for the first time, gather will start but because there are no registered servers, it will shut down

again. (Normal)


27

Chrome Connection

IP Name : Connect to Chrome via the port.

For first time login, the account/password is Admin/1.

Normal for the

initial start.


28

After login, you can change login information on Admin page.

Register Monitoring Server

Go to Menu > Server > Server

Click the Add button, and enter the monitoring server information (server in which the daemon is installed)

▪ Server ID : server name

▪ Server Alias : When you register the server ID, it is automatically saved/ Changes are allowed.


29

▪ Type : Select DB

▪ IP Address : Enter Monitoring IP

▪ Port : Enter MySQL Port

▪ DB Login ID :

▪ DB Password :

▪ Sysmon Port : Enter Sysmon Connection Port (Default : 9729)

▪ System Encoding : Select Encoding

▪ SQL Text Length : Select SQL Text Length

▪ Instance Name : Sysmon Environment Configuration File Name (Default : Instance01)

▪ Click the Save button, check the corresponding monitoring server, and click the Test Connection button – confirm

‘Success’.

▪ (Note) Menu > Server > Server’s Value Change -> Upon saving, you must restart Gather for changes to be

applied.

Enter the monitoring server

information in which Sysmon

daemon is installed.


30

Restart Gather

▪ Start Gather from Execution File (MaxGauge4MySQLWeb.exe)

▪ From Menu window, Process > Click Controller Start

After server check,

test connection.


31

Start Monitoring

Linux Version

Install File Upload

maxgauge4mysql.v4.2.151218.1629.install.LINUX.tar File Upload

Upload file in install location.

Create directory to unzip files

Create directory for Maxgauge For Mysql in the desired location by the administrator.

Default : install directory location/maxgauge/

Create maxgauge directory in the desired install location by the administrator.

mkdir maxgauge

Create tmp directory inside the maxgauge directory.

cd maxgauge

mkdir tmp


32

Move the upload files to Install Path /maxgauge directory, and unzip

Move the uploaded files to Install Path/maxgauge/ sysmon/bin/

mv maxgauge4mysql.v4.2.151218.1629.install.LINUX.tar Install Location/maxgauge/○1

Unzip

tar-xvf maxgauge4mysql.v4.2.151218.1629.install.LINUX.tar

Unzip and unzip the created x_conver.tar.file

Unzip

1 tar-xvf x_convert.tar

Move the zip file (Tar) to the directory created in step 2), maxgauge/tmp

Move the zip files to tmp location created in step 2) so that version can be checked afterwards.

mv maxgauge4mysql.v4.1.151218.1629.install.LINUX.tar Install Location/maxgauge/tmp

mv x_convert.tar Install Location/maxgauge/tmp

Or


33

1. mv maxgauge4mysql.v4.1.151218.1629.install.LINUX.tar tmp

2. mv x_convert.tar tmp

After moving to the unzipped x_convert directory, run chomod,sh script

Move to unzipped x_convert directory

cd x_convert

chmod.sh file execution (Automatic Granting Rights Shell Script)

./chmod.sh

In the event of a bad interpreter while executing the shell script in the Install Location/maxgauge/bin directory,

it returns an error!!

Normal

When an Error Occurs

1. Go to x_convert directory

2. Execute vi trans_interpreter.sh -> Configure T_INTERPRETER suitable to OS environment – Only ksh, bash

3. are acceptable.

4. ./trans_interpreter.sh


34

WAS Environment Configuration

1. Config.sh

Go to Install Location/maxgauge/bin/

cd Install Location/maxgauge/bin

Change config.sh Configuration

vi config.sh

2. System.properites

Go to Install Location/maxgauge/conf/properties

cd Install Location/maxgauge/conf/properties

Change system.properties Configuration

vi system.properties

System.properties


35

Gather Environment Configuration

1. Daemon.properties



Change daemon.properties Configuration

vi daemon.properties

Daemon.properties


36

Repository DB Environment Configuration

1. dbpool.properties



Change dbpool.properties Configuration

vi dbpool.properties

※ Different configuration method is used for each MySQL and MariaDB and therefore, please

reference the following information.

dbpool.properties(When installing on MySQL)

※ Check the results values of mydb.url and mydb.password in the following path and enter the

information.

Ex.) input String (Enter to quit) > root -> Enter user / password

input String (Enter to quit) > 74e586bf3478f17f4e1……. -> Outputs the result value accordingly.


37

dbpool.properties(When installing on MariaDB)

Insert license

Go to Install Location/maxgauge/conf/license

cd Install Location/maxgauge/conf/license

Upload the license file in the corresponding location.

Creating Repository DB and Procedure

Go to Install Location/maxgauge/bin/install

cd Install Location/maxgauge/bin/install

▪Execute install.sh file (Automatic install shell script)

./install.sh


38

※ When completed successfully, it will display the message, InstallDDL Result : Success

Process Start, End

Go to Install Location/maxgauge/bin


Process Execution (Automatic Install Shell Script)

WAS Start : ./bin/jetty.start.sh

WAS End : ./bin/jetty.stop.sh

Gather Start : ./bin/daemon.start.sh

Gather End : ./bin/daemon.stop.sh

All Start : ./bin/all.start.sh

All End : ./bin/all.stop.sh

WAS Start

Gather Star

All Start


39

Process Status Check

Go to Install Location/maxgauge/bin


Process Execution (Automatic Install Shell Script)

○1 Status Check : ./bin/all.ps.sh

Status Check

※ When activating daemon for the first time, because it is not yet registered in the server, its

status will appear as ‘shutdown’.

Follow the same configuration steps from section 3.6, step 9). ( Please see p.21 ~ p.23 of

this document.)

After daemon has started, status check


40

To find out more about

MaxGauge or If you have

interesting about this product,

contact MaxGauge.

--------------------------------------------------

www. MaxGauge.com

TEL : 714-855-3981

E-MAIL : [email protected]

ADDRESS : 20280 S Vermont Ave Suite200

Torracne, CA 90502, USA

ABOUT US

MaxGauge, INC is a solution based technology

company that has been providing database

optimization and tuning services since 2001 with our

software solution. We have served 450 clients

across a wide range of industries including finance,

manufacturing, government, healthcare,

telecommunication, etc.

http://www.maxgauge.com/

mailto:[email protected]

Date post:	04-Jul-2020
Category:	Documents
Upload:	others
View:	4 times
Download:	0 times

MFM 4 - EXEM€¦ · 1 minute Create Procedure and Tables Click the ‘Create Repository DDL’...

Documents