1. Introduction

This manual describes the installation procedures for SmartSense Agent.

2. Install Preparations

This section covers the essential steps required for the installation.

Attention

All steps must be performed with root privileges unless stated otherwise.

To install SmartSense Agent you will need:

  • Root permission on the server
  • SmartSense Agent .rpm file

Note

If you do not have the file, contact Griaule Support Team at support@griaule.com.

Warning

Make sure that the version of the SmartSense Agent you are installing is compatible with the version of the GBDS that is installed.

Then, follow the steps presented below.

  1. Login to the server as root.
  2. Install SmartSense Agent.

3. Installing SmartSense Agent

Transfer or download the .rpm file on the server.

Change to the directory where the .rpm file is located and run the command:

Note

Make sure to replace <version> with the version of the SmartSense Agent you are installing.

rpm -ivh gbs-smartsense-agent-<version>.rpm
                              ^^^^^^^^^

Then, edit the SmartSense Agent configuration file:

vim /etc/griaule/conf/gbs-smartsense-agent/application.properties

Pay special attention to the following properties, making sure to set the correct hostname, database username, and password where indicated:

gbds.rdb.url=jdbc:mysql://<HOSTNAME>:3306/gbds?useSSL=false
                          ^^^^^^^^^^

gbds.rdb.username=<DB-Username>
                  ^^^^^^^^^^^^^

gbds.rdb.password=<DB-Password>
                  ^^^^^^^^^^^^^

Finally, start the SmartSense Agent:

/var/lib/griaule/gbs-smartsense-agent/scripts/start-smartsense.sh

And follow the startup log:

/var/lib/griaule/gbs-smartsense-agent/scripts/tail-smartsense.sh

3.1. Aliases

Aliases are short, user-defined commands that serve as replacements for longer or more complex commands. They are created to make frequently used commands more convenient to execute. When an alias is invoked, it gets replaced by the full command it represents before it is executed.

To add the SmartSense Agent aliases, open the root .bashrc file:

vim /root/.bashrc

Then, add the following aliases:

alias agentstart='/var/lib/griaule/gbs-smartsense-agent/scripts/start-smartsense.sh'
alias agentstop='/var/lib/griaule/gbs-smartsense-agent/scripts/stop-smartsense.sh'
alias agentstatus='/var/lib/griaule/gbs-smartsense-agent/scripts/smartsense-status.sh'
alias agenthome='cd /var/lib/griaule/gbs-smartsense-agent/'
alias agentlogt='/var/lib/griaule/gbs-smartsense-agent/scripts/tail-smartsense.sh'
alias agentconf='vim /etc/griaule/conf/gbs-smartsense-agent/application.properties'