PowerFlex 3.X: How to rename PowerFlex Gateway post-deployment

Summary: This article explains the detailed steps for how to rename the gateway after deployment

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

This KB outlines renaming a 3.x PowerFlex Gateway (GW) post-deployment. 

This KB does not apply to 4.x versions.

If SRS is configured, it must be reconfigured after the GW is reinstalled.

 

   Steps:

1) Remove the GW service, if any, and remove it as a Resource

2) Remove the Service tied to the PowerFlex Gateway

3) Backup the gatewayUser.properties file:

cp /opt/emc/scaleio/gateway/webapps/ROOT/WEB-INF/classes/gatewayUser.properties /tmp/

 

4) Uninstall the GW RPM: 

rpm -e $(rpm -qa | grep "EMC-ScaleIO-gateway")

 

5) Rename the host as desired: 

#set new hostname
hostnamectl set-hostname your-new-hostname

#reboot host
shutdown -r

 

6) Reinstall the PowerFlex GW RPM: 

GATEWAY_ADMIN_PASSWORD='<gw_admin_password>' rpm -ivh 

 

7) Replace the gatewayUser.properties file with the one backed up: 

cp /tmp/gatewayUser.properties /opt/emc/scaleio/gateway/webapps/ROOT/WEB-INF/classes/gatewayUser.properties

 

8) Restart the GW service: 

systemctl restart scaleio-gateway.service

9) Create a lockbox and store the MDM credentials:

10) Log in to the PowerFlex Gateway UI and navigate to the 'Maintain' tab. Approve the MDM/LIA certificates, then switch MDM ownership and repeat this for all Secondary MDMs

11) Add the GW back as a resource

12) Add the Existing Service back

13) Validate that the UI displays the updated GW name

Additional Information

If Secure Remote Services is configured, it must be reconfigured after the GW is re-installed.

This process is necessary due to the certificates created during install.

Affected Products

PowerFlex rack, PowerFlex Appliance
Article Properties
Article Number: 000262027
Article Type: How To
Last Modified: 03 Jan 2026
Version:  2
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.