EcoStruxure IT Gateway appliance version 1.9 and older

Support for Gateway Appliances ended in December 2023. It is strongly advised that you migrate to a new installation of the Gateway software. See How to replace your EcoStruxure IT Gateway with a new installation   There are several tools provided with the Gateway appliance to help you troubleshoot the device if needed. All of these tools are available in Webmin. To access Webmin, connect a laptop to the Gateway appliance private network (Port 2), open a browser, and go to https://192.168.0.1:10000.   Tools   After you log in to Webmin, go to System Configuration >Tools to find utilities to help you troubleshoot the appliance.   webmin_tools_360019038233.jpg   Check EcoStruxureITGateway Status   This is a one-click command to see the current running state of the system. It outputs current IP configuration on all ethernet adapters, state of the EcoStruxure Gateway services, and the Gateway version information. Additionally, the command will try to confirm the status of the Gateway webserver on all available networks. Each attempt will return an HTTP status code. Typically, you will see a 000 code if the webserver was not running and a 200 code if it is online and running properly.   Note: Starting with Gateway version 1.8.0, the HTTP status return codes for the Gateway Server Web API incorrectly return as 403 when the system is actually working normally. This is a false failure and should be disregarded.    Configure DHCP Interface   Use this utility to configure which physical adapter is listening for DHCP client requests. By default, this is set to the Private network, Port 2 (eth1). Use this utility to set the value DISABLED to turn off listening for DHCP requests. This is especially useful when putting a Gateway appliance along side a DCE on the private side of the DCE where the DCE is the DHCP provider.   Reboot Server   This executes an OS level system reboot of the Gateway appliance.   Reset Gateway Admin Password   This utility resets the Gateway "admin" user password back to the default password in case you lock yourself out. Run the reset script and then restart the Gateway services for the change to take effect. This reset only affects the "admin" user account.   Restart EcoStruxure IT Gateway   This utility performs an OS level service restart on both Gateway services: the web application and the database.   Restore to Defaults   This utility reverts the selected component back to default values:   Webmin - Reverts any Webmin customization back to default. This restarts Webmin; you will temporarily lose connection   Network - Reverts eth0 and eth1 to their default out of box config. Also clears values from /etc/resolve.conf (DNS entries) and /etc/sysconfig/network (hostname) After reverting, it initiates an OS reboot.   DHCP - Recreates the DHCP scope and enables DHCP server on Private network, Port 2 (eth1) Gateway - Performs an uninstall / reinstall of the Gateway software using the installer included with the original ISO.   Shutdown Server   This initiates an OS shutdown. Someone needs to physically press the power button on the appliance to turn it back on. This should be used anytime the device needs to be powered off gracefully.   Start SSH server This issues a service start request for SSH on the appliance. By default, SSH is disabled.   Warning: Do not enable SSH access unless Schneider Electric technical support requests it for troubleshooting. Enabling SSH increases the risk of remote login attempts to your Gateway on the standard SSH port, and makes your system a potential target for obtaining shell access. Stop SSH server   This issues a service stop request for SSH on the appliance. Note that rebooting the device will also cause the SSH server to stop.

The Ecostruxure IT Gateway appliance comes with a DHCP server configured and enabled by default on the private network (eth1 interface in Webmin, port 2 on the Gateway appliance). WARNING: Running more than one DHCP server on the private network is not recommended. If you are deploying the Gateway on a private network that already has a DHCP server, such as from a Data Center Expert server,  you must disable the DHCP service on the Gateway or on the other device providing DHCP service. Disable the DHCP server on the EcoStruxure IT Gateway In Webmin, select System Configuration. Click Configure DHCP Interface.  GWA10_360022822093.png Type disable in the text field. Click Execute to stop and disable the DHCP service.  GWA11_360022822093.png Clicking Execute will display the following output. Click Return to commands.  GWA12_360022822093.png Enable (Re-enable) the DHCP server on the EcoStruxure IT Gateway private network Select System Configuration > Tools. Click Configure DHCP Interface.  GWA13_360022822093.png Enter eth1 in the field Click Execute to enable and start the DHCP services on the private network.  Clicking Execute will display the following output. Click Return to commands. Editing DHCP server settings Configure the DHCP server settings in the DHCP Server menu if the Gateway is going to provide DHCP services but you need to change the default settings. For example, change this setting if your private network uses a range of IP addresses different from the default. Click the DHCP profile 192.168.0.0 to open an Edit Subnet window to customize the DHCP IP address range, subnet mask, and many other configuration details. The Stop Server button stops the DHCP service. This change is only temporary and does not disable the service permanently. The DHCP service will restart if the Gateway is rebooted or the Start Server button is clicked. GWA16_360022822093.png GWA17_360022822093.png GWA18_360022822093.png Once edits are completed, click Save in the Edit Subnet window. Click Apply Changes to apply new DHCP settings immediately.  

Connect a laptop to the private network (Lan2 or Gb2) on the Gateway appliance,. Confirm that your laptop received a DHCP address from the Gateway. Its address will be 192.168.x.x. Open a browser on your laptop. Go to https://192.168.0.1:10000 to connect to Webmin and log in. Select System Configuration > Network Configuration, and then Network Interfaces. Select the Activated at Boot tab. GWA4_360026614013.jpg Click eth0. Change the IPv4 setting from DHCP to Static configuration and enter the desired IPv4 address and Netmask. Click Save. Do not click Save and Apply. GWA5_360026614013.jpg Click Return to network interfaces then click Return to network configuration. Click Routing and Gateways. GWA6_360026614013.jpg On the Boot time configuration tab in Default routes, choose Eth0 from the Interface dropdown, and specify the IP address of your network default gateway. Click Save. GWA7_360026614013.jpg Click Eth0. Click Hostname and DNS client. Specify a hostname (optional) and DNS server IP addresses. Note: When you configure a static IP address, you must provide DNS server information. Otherwise, the Gateway cannot resolve EcoStruxure domain names. Click Save. Click Return to network configuration. Click Apply the network configuration for changes to take effect.

The Gateway appliance private LAN subnet must be 192.168.x.x. You must contact support to change the Gateway appliance private LAN subnet to anything other than 192.168.x.x. See Can I change the default subnet for the Gateway appliance private LAN? Connect a laptop to the private network (LAN2 or Gb2) on the Gateway appliance,. Confirm that your laptop received a DHCP address from the Gateway. Its address will be 192.168.x.x. Open a browser on your laptop. Go to https://192.168.0.1:10000 to connect to Webmin and log in. Select System configuration > Network Configuration, and then Network Interfaces. Select the Activated at Boot tab. GWA8_360026459354.jpg Change the IPv4 setting from DHCP to Static configuration and enter the desired IPv4 address and Netmask on the 192.168.x.x subnet only. Click Save and Apply. At this point you will lose your connection with Webmin. Reconnect using the new IP address you just configured on the private network. GWA9_360026459354.png