Installing EcoStruxure IT Gateway on CentOS minimal install

[EcoStruxureIT]

CentOS 7 (end of life June 2024) is not supported in Gateway 1.23 and newer.

System requirements for EcoStruxure IT Gateway 

For existing Gateway installations, deploy a new Gateway 1.23 on a supported Linux operating system: Rocky Linux 8 and 9; Red Hat Enterprise Linux 8 and 9

To retain sensor history, follow these instructions:

How to replace your EcoStruxure IT Gateway with a new installation

Red Hat installation instructions are here.

Requirements

CentOS 7 minimal install

EcoStruxure IT Gateway Linux installation file

IMPORTANT: The user running the Gateway installer must have file system privileges set to umask 0022. Otherwise, the installer cannot initialize the database.

Installation steps

1. Find out Centos 7 IP address. Centos 7 minimal install does not include ifconfig. Type ip addr

   Centos7_-_ifconfig_Command_360006401957.png

2. Transfer the Gateway installer using filezilla on sftp (port 22).

   Centos7_-_FTP_gateway_installer_360006401957.png

3. Putty/ssh to the Centos 7 server.

4. Set read/write/execute to the Gateway installation file. Type chmod 777 *

5. Type ./Eco*.run                       

   Centos7_-_Execute_Install_360006401957.png

6. Press and hold the Enter key until you see "Do you accept this license?"                                              Type Y and then enter.

7. Select Default (recommended). Type 1 and enter.

8. To continue, type Y and enter. Installation will start.

   Centos7_-_Accept_License_360006401957.png

9. Wait until the service is started.

   Centos7_-_Service_Started_360006401957.png

10. Completed

    Centos7_-_Install_Complete_360006401957.png

Accessing EcoStruxure IT Gateway

By default, HTTPS to CentOS is not allowed. To add it:

1. Type sudo firewall-cmd --permanent --add-service=https

   Centos7_-_Add_to_allow_360006401957.png

2. Stop the firewall and restart it. Type systemctl stop firewalld and systemctl start firewalld

   Centos7_-_Firewalld_360006401957.png

3. Open a web browser and go to https://your_centos_ipaddress/                                                               Enter a password for the admin user. 

4. Follow the prompts to configure settings and register the Gateway with EcoStruxure IT. For detailed instructions, see Installing and setting up EcoStruxure IT Gateway

5. In EcoStruxure IT, go to Administration > Gateways. You can see the Gateway is now connected to your account. 

   Centos7_-_Gateway_linked_360006401957.png

Allowing the Gateway to receive SNMP traps for APC devices and/or 3rd party SNMP devices

EcoStruxure IT Expert uses only UDP port 1062 for both APC NMC and 3rd party SNMP traps. CentOS does not allow port 1062 for incoming SNMP trap on its default settings.

In Gateway 1.10 and newer, you can configure additional SNMP ports in the Settings > Advanced > SNMP trap ports option. See Configure SNMP trap ports

1. To check which inbound ports are allowed:

Type sudo firewall-cmd –list-ports

It will return empty if no incoming port is allowed

mceclip1_360006401957.png

2. To allow incoming SNMP trap on port 1062:

Type  sudo firewall-cmd –add-port=1062/udp --permanent

set_port_1062_360006401957.png

3. Next, stop/start firewalld or use restart:

1. Type sudo systemctl restart firewalld
2. Check allowed ports. It should list 1062/udp 
3. Type sudo firewall-cmd –list-ports

list_port_360006401957.png