Help
  • Explore Community
  • Get Started
  • Ask the Community
  • How-To & Best Practices
  • Contact Support
Notifications
Login / Register
Community
Community
Notifications
close
  • Forums
  • Knowledge Center
  • Events & Webinars
  • Ideas
  • Blogs
Help
Help
  • Explore Community
  • Get Started
  • Ask the Community
  • How-To & Best Practices
  • Contact Support
Login / Register
Sustainability
Sustainability

We Value Your Feedback!
Could you please spare a few minutes to share your thoughts on Cloud Connected vs On-Premise Services. Your feedback can help us shape the future of services.
Learn more about the survey or Click here to Launch the survey
Schneider Electric Services Innovation Team!

Installing and setting up EcoStruxure IT Gateway

Gateway software installation and setup

Step-by step instructions for how to download, install, and set up the EcoStruxure IT Gateway

cancel
Turn on suggestions
Auto-suggest helps you quickly narrow down your search results by suggesting possible matches as you type.
Showing results for 
Show  only  | Search instead for 
Did you mean: 
  • Home
  • Schneider Electric Community
  • EcoStruxure IT Help Center
  • EcoStruxure IT Help Center Categories
  • Gateway
  • Gateway software installation and setup
  • Installing and setting up EcoStruxure IT Gateway
Options
  • Mark as New
  • Mark as Read
  • Bookmark
  • Subscribe
  • Email to a Friend
  • Printer Friendly Page
  • Report Inappropriate Content
Invite a Co-worker
Send a co-worker an invite to the portal.Just enter their email address and we'll connect them to register. After joining, they will belong to the same company.
You have entered an invalid email address. Please re-enter the email address.
This co-worker has already been invited to the Exchange portal. Please invite another co-worker.
Please enter email address
Send Invite Cancel
Invitation Sent
Your invitation was sent.Thanks for sharing Exchange with your co-worker.
Send New Invite Close

Related Forums

  • EcoStruxure IT forum

  • APC UPS Data Center & Enterprise Solutions Forum

Previous Next

Invite a Colleague

Found this content useful? Share it with a Colleague!

Invite a Colleague Invite

EcoStruxure IT Support

Submit a support request for additional assistance with EcoStruxure IT software.

Request Support
Back to Gateway software installation and setup
Options
  • Mark as New
  • Mark as Read
  • Bookmark
  • Subscribe
  • Email to a Friend
  • Printer Friendly Page
  • Report Inappropriate Content
2 Likes
39551 Views

Link copied. Please paste this link to share this article on your social media post.

Trying to translate this page to your language?
Select your language from the translate dropdown in the upper right. arrow
Translate to: English
  • (Français) French
  • (Deutsche) German
  • (Italiano) Italian
  • (Português) Portuguese
  • (Русский) Russian
  • (Español) Spanish

Installing and setting up EcoStruxure IT Gateway

Picard EcoStruxureIT
‎2018-11-13 06:21 AM

Last Updated: Sisko JLehr Sisko ‎2025-06-16 02:03 PM

security_icon_360012105013.pngsecurity_icon_360012105013.png To reduce the attack surface, it is strongly recommended that you restrict access to the server and file system where EcoStruxure IT Gateway is installed.

 

On this page:

 

  • Prerequisites
  • Sign up and create an EcoStruxure IT account
  • Links to instructions for installing the Gateway on Windows or Linux
  • Configure device credentials
  • Discover devices
  • Register and connect the Gateway to EcoStruxure IT

 

Prerequisites

 

    • A server or a PC that is always on with:
      • English install of Microsoft® Windows® 10 and 11 64-bit, Server 2016, Server 2019, and Server 2022
      • Rocky Linux 8 and 9; Red Hat Enterprise Linux 8 and 9

       

    • At least 2GB hard disk space. See system requirements

       

    • The required CPU and memory depends on the number of monitored devices and the protocol.
      See system requirements

       

    • Network:
      Port 443 outbound for connecting to EcoStruxure IT
      Port 443 inbound locally for accessing the Gateway web interface
      See system requirements

       

    • Devices to be monitored must be accessible over the network from the EcoStruxure IT Gateway.
      The ports used to communicate with devices vary based on communication protocol and device settings.

 

Checklist to help you deploy your Gateway

 

1. Sign up and create an EcoStruxure IT account

 

Create a new EcoStruxure IT account here or log in if you already have an account.

 

Follow the on-screen instructions to download the EcoStruxure IT Gateway.

 

Installing the EcoStruxure IT Gateway

 

Installation instructions for Windows  video icon 25.png

 

Installation instructions for Linux

 

After you install the Gateway, open a browser on any computer with network access to the Gateway and go to https://<ip address or hostname>/gateway/index.html.

 

If the browser you are using is on the same system you installed EcoStruxure IT Gateway on, you can access the Gateway at https://localhost/gateway/index.html. 

 

Set the password for the system administrator. The default username is admin. 

 

GW18_set_admin_password_at_first_login_2_360012105013.PNGGW18_set_admin_password_at_first_login_2_360012105013.PNG 

 

Need to configure cloud connectivity settings?

 

The Gateway server must use the internet to communicate with EcoStruxure IT.

 

If the Gateway is not connected to EcoStruxure IT, messages and recommended actions are displayed on the Cloud connectivity page. Otherwise, the Device credentials page is displayed.

See Configuring cloud connectivity in the Gateway

 

cloud-connection-failed_360012105013.pngcloud-connection-failed_360012105013.png

 

 

 

2. Configure device credentials

 

Configuring the EcoStruxure IT Gateway   video icon 25.png

 

 

Discovery and polling

 

These settings are used by EcoStruxure IT Gateway to discover and poll devices. You can reuse these credentials for all your device discoveries and add additional credentials as needed.

 

Click New device credentials and select the communication protocol used by your devices. Specify a label that allows you to identify the credential along with the following settings depending on what protocol you selected:

 

  • SNMPv1: Specify the Read community name (public is default), the Write community name (private is default), and the port, (161 is default).

  • SNMPv3: Specify the Username, Authentication type (MD5 or SHA), Authentication password, Encryption type (DES, DES3, AES128, AES192, AES256), Encryption password, and Port (161 is default).

    When AES is configured in the APC Network Management Card (NMC) interface, choose AES128 in the Gateway user interface.

    EcoStruxure IT Gateway versions older than 1.15 do not allow discovery of SNMPv3 devices with the Authentication type or Encryption type set to None.

    Need help configuring your APC NMC devices? 

  • NetBotz: Specify the Username, Password, and Port (80 is default, or 443 with SSL enabled).

    Need help configuring your NetBotz devices?

  • Redfish: Specify the Username, Password, and Port (443 is default).

 

Device configuration and firmware update

 

File transfer settings for the APC Network Management Card are required to allow the Gateway to transfer files to and from monitored APC SNMP devices.

 

These settings must be properly configured for device configuration, firmware update, and other EcoStruxure IT features to function properly.

 

  1. Click New file transfer credentials and select SCP or FTP.
  2. Specify a name for the configuration, and the username, password, and port. 

Note: The EcoStruxure IT Gateway does not support SCP on NMC1 devices.

 

When one or more file transfer credentials are configured, the Gateway uses the provided credentials to gather certain device information daily.

 

Some EcoStruxure IT features such as firmware update and device configuration also rely on additional file transfers to and from the device.

 

Make sure the Gateway has valid device file transfer credentials to prevent unnecessary unauthorized access attempt warnings from being triggered on your devices.

 

Your APC NMC3 devices might be configured to limit the number of failed login attempts.
If the number of device file transfer credentials you provide in the Gateway exceeds the number of failed login attempts allowed on the NMC3 device, the device might be locked.

See New cybersecurity requirements in NMC3

 

 

GW19_device_credentials_360012105013.pngGW19_device_credentials_360012105013.png

 

3. Discover devices

 

You can import a device list from Data Center Expert or another source to easily discover devices in EcoStruxure IT Gateway 1.8.0 and newer. See Import a device list to discover devices in EcoStruxure IT Gateway

 

  1. Go to Discover devices.
  2. Click Configure Credentials to select specific device file transfer credentials to use in a device discovery. Otherwise, all configured credentials will be used.

 

To comply with stricter cybersecurity requirements across various product groups, it is recommended that you review your username/password lists in EcoStruxure IT Gateway and confirm that configured credentials are both active and accurate.

 

You can run multiple discoveries simultaneously.

 

You can import a device list that contains the IP address for each device.

 

To discover devices manually, specify an IP address or IP address range. Use an asterisk to search an entire subnet: 192.168.1.* Use a dash to search a range of IP addresses: 192.168.1.100-254.

 

You can specify multiple IP addresses or IP address ranges separated by commas.

 

idea_icon_360007070737.pngidea_icon_360007070737.png Check out the on-screen device discovery tips!

 

 

Modbus discovery

To discover Modbus devices, click Discovering a Modbus device? 

 

To discover Modbus devices manually, specify the Device type, Device vendor, Device family, and Server address. For TCP, specify the IP address and Port (502 is default). For Serial (RTU), specify the Port, Baud rate, Data bits, Parity, Stop bits, and Flow control.

 

Importing a device list

You can import a device list that contains the IP address and server address for each Modbus device. Each line must have both the IP address and server address.

 

IMPORTANT: On the Gateway Discover devices page, you must also specify the Device type, Device vendor, and Device family. For TCP, also specify the Port (502 is default). For Serial (RTU), you must also specify the Port, Baud rate, Data bits, Parity, Stop bits, and Flow control.

 

Discovery results

If device discovery fails, there are messages and suggestions on how to fix the issue on the page.

 

GW18_Discover_Devices_360012105013.pngGW18_Discover_Devices_360012105013.png 

 

GW18_discover_devices_no_errors_360012105013.pngGW18_discover_devices_no_errors_360012105013.png

 

Click Go to devices to see all discovered devices listed on the Devices page.

Click Discovery log to see additional discovery results.

 

GW18_Device_Discovery_Log_360012105013.pngGW18_Device_Discovery_Log_360012105013.png

 

Click View details under the count of unsupported devices to see the list of devices not yet supported in EcoStruxure IT, if any. To request device support, click Need device support? Submit a DDF Request.

 

GW18_device_not_supported_360012105013.pngGW18_device_not_supported_360012105013.png

 

4. Register and connect the Gateway

 

Click the Register Gateway button and follow the on screen instructions to connect your Gateway to your EcoStruxure IT organization.

If you are not logged into EcoStruxure IT, log in to connect your Gateway. You might be prompted for the 2 factor authentication code you chose when you set up your EcoStruxure IT account.

Note: The 2 factor authentication code you need to log in is not the same as the Gateway registration code.

 

idea_icon_360012105013.pngidea_icon_360012105013.png

If you have not yet signed up for an organization in EcoStruxure IT sign up here. Once you have an an account in EcoStruxure IT, click the Register Gateway button and follow the on screen instructions.

 

After you log in to EcoStruxure IT, you'll see the Connect Gateway dialog with the Gateway registration code pre-populated.

 

If the registration code isn't prepopulated, for example if you login to the Gateway using a different browser than you use to log in to EcoStruxure IT, you can go to Administration > Gateways > Connect Gateway in the EcoStruxure IT web interface and manually enter the Registration code.

 

GW18_register_Gateway_360012105013.JPGGW18_register_Gateway_360012105013.JPG

GW18_connect_Gateway_in_ITE_360012105013.pngGW18_connect_Gateway_in_ITE_360012105013.png

GW18_EIT_administration_page_360012105013.PNGGW18_EIT_administration_page_360012105013.PNG

 

Return to the Gateway user interface and click Done.

Note: The setup wizard appears each time you access the Gateway until you click Done. All settings you configure in the wizard are applied whether or not you click Done on the last page of the wizard.

 

See also

Installing the EcoStruxure IT mobile app

Was this article helpful? Yes No
100% helpful (2/2)

Link copied. Please paste this link to share this article on your social media post.

Didn't find what you are looking for? Ask our Experts
To The Top!

Forums

  • APC UPS Data Center Backup Solutions
  • EcoStruxure IT
  • EcoStruxure Geo SCADA Expert
  • Metering & Power Quality
  • Schneider Electric Wiser

Knowledge Center

Events & webinars

Ideas

Blogs

Get Started

  • Ask the Community
  • Community Guidelines
  • Community User Guide
  • How-To & Best Practice
  • Experts Leaderboard
  • Contact Support
Brand-Logo
Subscribing is a smart move!
You can subscribe to this board after you log in or create your free account.
Forum-Icon

Create your free account or log in to subscribe to the board - and gain access to more than 10,000+ support articles along with insights from experts and peers.

Register today for FREE

Register Now

Already have an account? Login

Terms & Conditions Privacy Notice Change your Cookie Settings © 2025 Schneider Electric

This is a heading

With achievable small steps, users progress and continually feel satisfaction in task accomplishment.

Usetiful Onboarding Checklist remembers the progress of every user, allowing them to take bite-sized journeys and continue where they left.

of