How to rename PowerFlex Gateway post-deployment

Summary: This KB outlines renaming a 3.x PowerFlex Gateway (GW) post-deployment. This KB does not apply to 4.x versions. NOTE: If Secure Remote Services (Secure Remote Services) is configured, it must be reconfigured after the GW is re-installed. ...

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.
Check out other resources

Instructions

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

2) Remove the Service tied to the PowerFlex Gateway.

3) Back up the "gatewayUser.properties" file

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

4) Uninstall the PowerFlex GW RPM.

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

5) Rename the host as wanted.

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

#reboot host
shutdown -r

6) Re-install the PowerFlex GW RPM.

GATEWAY_ADMIN_PASSWORD='<gw_admin_password>' rpm -ivh "EMC-ScaleIO-gateway-xxx.rpm"

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

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.

mdm_pass='<mdm_passwrd>'
/opt/emc/scaleio/gateway/bin/FOSGWTool.sh --set_mdm_credentials --mdm_user admin --create_default_lockbox --mdm_password "${mdm_pass}"

10) Log in to the PowerFlex Gateway UI and go 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 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: 02 Jan 2025
Version:  1
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.