GSM Agent
Installation & Features Guide

User’s Manual
Version: 1.01

Copyright© 2018 GIGA-BYTE TECHNOLOGY CO., LTD. All rights reserved. The trademarks mentioned in thismanual are legally registered to their respective owners.

Disclaimer
Information in this manual is protected by copyright laws and is the property of GIGABYTE.
Changes to the specifications and features in this manual may be made by GIGABYTE without priornotice. No part of this manual may be reproduced, copied, translated, transmitted, or published inany form or by any means without GIGABYTE's prior written permission.

For More Information
For related product specifications, the latest firmware and software, and related information,please visit our website at:

http://www.gigabyte.com
For GIGABYTE distributors and resellers, additional sales & marketing materials are available fromour reseller portal:

http://reseller.b2b.gigabyte.com
For further information & technical assistance, please contact your GIGABYTE sales representative.
You may also message GIGABYTE server directly by email, Facebook or twitter
Email: server.grp@gigabyte.com
Facebook: https://www.facebook.com/gigabyteserver
Twitter: https://twitter.com/GIGABYTEServer

1Table of Contents
1.

About GSM Agent ............................................................................................................... 1

2.

Installation / Startup / Uninstallation.................................................................................. 2
2.1

3.

Installation............................................................................................................................. 2

2.1.1

OS: Ubuntu .................................................................................................................................................. 2

2.1.2

OS: Fedora / RHEL / CentOS ........................................................................................................................ 2

2.1.3

OS: Windows Server.................................................................................................................................... 2

2.2

Startup .................................................................................................................................. 2

2.3

Uninstallation ........................................................................................................................ 3

2.3.1

OS: Ubuntu .................................................................................................................................................. 3

2.3.2

OS: Fedora / RHEL /CentOS ......................................................................................................................... 3

2.3.3

OS: Windows Server.................................................................................................................................... 3

Using GSM Agent ................................................................................................................ 4
3.1

Logging in .............................................................................................................................. 4

3.2

Main Dashboard .................................................................................................................... 5

3.3

Monitor Functions.................................................................................................................. 6

3.3.1

System: CPU ................................................................................................................................................ 6

3.3.2

System: Memory ......................................................................................................................................... 7

3.3.3

System: Log ................................................................................................................................................. 7

3.3.4

System: NIC ................................................................................................................................................. 8

3.3.5

System: Information .................................................................................................................................... 8

3.3.6

System: PCI .................................................................................................................................................. 8

3.3.7

Storage: RAID .............................................................................................................................................. 93.3.8

Storage: S.M.A.R.T. .................................................................................................................................... 11

3.4

Notification Function............................................................................................................ 12

3.5

Preference Functions............................................................................................................ 13

3.5.1

Language ................................................................................................................................................... 13

3.5.2

Scan Period ............................................................................................................................................... 13

3.5.3

Log Amount ............................................................................................................................................... 13

3.5.4

SMTP ......................................................................................................................................................... 13

3.5.5

SNMP ........................................................................................................................................................ 14

3.5.6

LDAP .......................................................................................................................................................... 14

3.5.7

Change Password ...................................................................................................................................... 14

3.5.8

Update ...................................................................................................................................................... 142

3.6

Help..................................................................................................................................... 153

1. About GSM Agent
GSM Agent is part of the GSM (GIGABYTE Server Management) software suite. It is a software program tocompliment and assist the remote monitoring and management of GIGABYTE servers.

GSM Agent should be installed locally on each GIGABYTE server node. It collects node information (CPU /memory / HDD / PCIe devices) from the operating system and shares this information with the local BMC.
This information can then be used and displayed by GSM Server, GSM’s remote monitoring andmanagement software platform.
GSM Agent can be used with both Linux & Windows operating systems.

12. Installation / Startup / Uninstallation
2.1 Installation
2.1.1 OS: Ubuntu
Before installation, please ensure packages sudo and ufw are already installed. Otherwise,
GSM Agent installation will fail.
#apt-get install sudo ufw#dpkg -i gsmagent_x.x_all.deb

2.1.2 OS: Fedora / RHEL / CentOS
Before installation, please ensure packages sudo and ufw are already installed. Otherwise,
GSM Agent installation will fail.
# yum install sudo firewalld# rpm -ivh GSM_agent-x.x-1.x86_64.rpm

2.1.3 OS: Windows Server
Execute GSM_Agent_x.x.exe

2.2Startup

GSM Agent starts automatically when the system boots each time.
For Windows systems, the user needs to add port 8080 and 8443 to firewall exception.
For Ubuntu or Linux systems, if /dev/ipmi0 doesn’t exist, the user should use the command“modprobe ipmi_devintf”

2

2.3 Uninstallation
2.3.1 OS: Ubuntu# dpkg -r gsmagent

2.3.2 OS: Fedora / RHEL /CentOS# rpm -e GSM_agent-x.x-1.x86_64

2.3.3 OS: Windows Server
System > Control Panel > GSM Agent Installer33. Using GSM Agent
3.1 Logging inConnect using http://localhost:8080/GSM_Agent/
Default username: admin
Default password: password4

3.2 Main Dashboard

53.3 Monitor Functions
3.3.1 System: CPUDisplays idle / usage information about CPUs or cores6

3.3.2 System: Memory
Displays usage status of memory, virtual memory and huge pages

3.3.3 System: Log
GSM Agent records events from the system and BMC on this page7

3.3.4 System: NIC
This page displays information about the system’s network configuration including IP
address, MAC address and interface name.

3.3.5 System: Information
This page displays system information about the OS, CPU, Memory, Hostname, BMC
Version and BMC IP.

3.3.6 System: PCI
This page displays information about PCIe devices installed in the system

8

3.3.7 Storage: RAID
This page lists RAID health data from logical and physical layers. It includes two RAID
types, hardware and software.
Software RAID array info:
Level: RAID level
Array Size: RAID array sizeState: Health state
Number of Disks: Number of devices
Spare Disks: Number of spare devices
Chunk Size: Component disks9Hardware RAID array info:
Level: RAID level
Array Size: RAID array sizeState: Health state
Number of Disks: Number of devices
Spare Disks: Number of spare devices
Chunk Size: Component disks10

3.3.8 Storage: S.M.A.R.T.
The S.M.A.R.T. page lists the current health state of each disk

11

3.4 Notification Function
Notification allows you to set upper limit for CPU and memory usage.
When the system is running and the CPU or memory usage reaches or exceeds the setlimit, GSM Agent will send an alert to the user.

12

3.5 Preference Functions
3.5.1 Language
Select the language setting for GSM Agent

3.5.2 Scan Period
Select the scan period setting for retrieval of system information

3.5.3 Log AmountSet the default number of entries for the Monitor: System: Log page

3.5.4 SMTP
Configure SMTP information to send an email when the system is abnormal.

13

3.5.5 SNMP
Configure SNMP trap IP to receive events when the system is abnormal

3.5.6 LDAP
Configure LDAP server for LDAP authentication

3.5.7 Change Password
Change GSM Agent login password

3.5.8 Update
Update GSM Agent software version (.war file)14

3.6 Help
Provides basic visual help guidance for each function within GSM Agent (similar to thecontents of this user guide)15