Skip to main content
Sign Out

Welcome to Dell

My Account
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.
Sign In Create an Account Dell Financial Services Premier Sign In Partner Program Sign In
Contact Us

Your Dell.com Carts

Article Number: 000188603

PowerFlex: How to redeploy a PowerFlex Gateway

Summary: This article provides the procedure for redeploying a PowerFlex Gateway (GW).

This article may have been automatically translated. If you have any feedback regarding its quality, please let us know using the form at the bottom of this page.

Article Content

Instructions

Goal:

To successfully redeploy a PowerFlex Gateway (GW).
 

Facts:

A PowerFlex GW redeployment may be required for many reasons:

  • Preparing for an automated SVM replacement.

  • Replacing the old SUSE Linux Enterprise Server with CentOS.

  • Systems that are built in the factory use PowerFlex Manager or some other method in which the GW is not involved. Later, for upgrades or replacements, you must introduce it to the environment again.

NOTE: PowerFlex Gateway is also mentioned as VxFlex OS Gateway in version 3.0.x.
 

Procedure:

Ensure that you take a backup of the current GW. This ensures that all the existing properties and setting are copied to the new GW. To take a backup of the current GW, do the steps that follow:

  1. SSH to the IP of the current GW and login as root.

  2. Run the following command to go to the GW folder:

    cd /opt/emc/scaleio/gateway/bin/

  3. Run the following command to export the GW configuration file to the temporary folder.

NOTE: The original name of the script in older versions was SIOGWTool.sh.

./FOSGWTool.sh --export_gw_cfg --pack_linux_os_files --t /tmp/

  1. Run the following command to go to the temporary folder:

    cd /tmp

    NOTE: The exported gateway configuration file is named as name gw_config.tar.

  2. Copy the file in the local drive.

  3. If required, run the following commands and copy paste their outputs in a notepad:

hostname
ifconfig
netstat -rn
cat /etc/resolv.conf

  1. Run the following command to shut down the server:

    shutdown now -h

  2. Rename the current GW as follows:

    1. Log in to the vCenter where the current GW resides.

    2. On the left pane, go to the current GW VM.

    3. Right click on the GW VM and click Rename.

    4. Enter the new name and click OK.


Complete the following steps to deploy the new GW OVA template:

  1. From the Dell Support website, download the complete software bundle for the PowerFlex version running. You must be signed in to see all the downloads.

  2. Extract the packages from the downloaded file.

  3. From the PowerFlex <version> Complete VMware SW directory, save the OVA template.

  4. Use the VMware vSphere Client to connect to vCenter.

  5. From the main window, select Hosts and Clusters.

  6. From the left panel, select the ESXi on which you want to deploy the OVA.

  7. Right-click it, and select Deploy OVF Template.
    The Deploy OVF Template wizard appears.

  8. Enter the full path to the OVA that you had saved, and click Next.

  9. Assign a unique name to the VM, and select a VSAN storage to deploy the OVA, accept remaining default values in the wizard, and click Finish.

    NOTE: Ensure you are using the same name of the VM that you saved using the hostname command. It may take some time for the OVA to finish deploying.

  10. Right-click the new VM, and click Edit Settings.

  11. Ensure that you have enough CPU RAM and memory, assign the adapters to the right network, and then click OK.

  • CPU = 2vCPU

  • Memory: 8 GB

  1. Power up the new GW VM.

  2. Configure the new PowerFlex GW hostname and network interfaces:

    1. Using the console, start the new PowerFlex GW, and log in.

NOTE: The default username is root, and the default password is admin.

  1. Run the following command to configure the Network Management UI:

nmtui

  1. Select Set system hostname and press Enter.

  2. Enter the hostname, and click OK.

NOTE: Ensure you are using the same name of the VM that you saved using the hostname command.

  1. Select Edit a connection and press Enter.

  2. Select Ethernet > Wired connection 1, and click Edit.

  3. Change Profile name to eth0.

  4. Change IPv4 CONFIGURATION to Manual, and click Show.

  5. Configure the network:

    • IP address

    • Gateway address

    • DNS server

NOTE: Ensure you are using the network details of the VM that you saved earlier.

  1. Change IPv6 CONFIGURATION to Ignore, and click OK.

  2. Configure the PowerFlex Data networks: 

    1. Select Edit a connection and press Enter.

    2. Select Ethernet > Wired connection 2, and click Edit.

    3. Change Profile name to eth1.

    4. Change IPv4 CONFIGURATION to Manual, and click Show.

      • Repeat the PowerFlex Data network steps for each additional data network.

    5. Configure the network:

      • IP address

      • Gateway address

      • DNS server

NOTE: Ensure you are using the network details of the VM that you saved earlier.

Wired Connection Table

NOTE:
v1 = Nonbonded NIC port design
v2 = Static bonding NIC port design
v3 = LACP bonding NIC port design

  1. Click Back, and then Quit.

  2. Run the following command to reboot:

reboot

  1. Connect to the server using the IP of the current GW and do the following steps:

    1. Run the following command to verify if the new operating system is available:

cat /etc/*release

  1. Copy the old GW configuration file from your local to /root/ folder.

NOTE: Import the old GW configuration file into the new GW only if the Secure Remote Services integration is in use with the VxFlex OS GW. We do not do this on most of the systems as the Secure Remote Services integration is with the PowerFlex Manager. Most of the time the GW restore is not needed.

The GW configuration file is successfully imported.

  1. Do the following steps to add the RPM, set the MDM IPs, and add the certificates:

    1. Ensure that you are connected to the server using the IP of the current GW.

    2. Install Java. Use the openjdk headless version.

The Java RPM file should be in the /root/install folder on the GW.

If it is not, download the correct Java version for your RCM or IC.

  1. Run the following command to install the java RPM:

rpm -ivh <java_package_name>.rpm

  1. If the EMC-ScaleIO-gateway-3.X-X.<build>.x86_64.rpm file is not available in /root/install folder, copy the file from the extracted download file from your local system to /root/install folder.

  2. Run the following command to install the PowerFlex Gateway, where X is the version number: 

GATEWAY_ADMIN_PASSWORD=<new_GW_admin_password> rpm -ivh EMC-ScaleIO-gateway-3.X-X.<build>.x86_64.rpm

  1. <new_GW_admin_password> is a password that you define to access the PowerFlex Installer.

The password must meet the following criteria:

  • At least eight characters long

  • Include the following groups: [a-z], [A-Z], [0-9]

  1. Log in to the PowerFlex Gateway Web UI and do the following steps:

    1. Ensure that the new version of Installation Manager is displayed on the main page.

    2. On the menu, click Maintain.

    3. Enter the primary MDM IP, username, password, and LIA password.

    4. Approve all MDM certificates when prompted.

    5. Click Retrieve system topology and ensure that all the LIA authentications are valid.

  2. Copy the IPs of the Cluster, primary MDM, and the secondary MDMs. 

  3. Run the following commands to check the user properties in the GW server:

    cd  /opt/emc/scaleio/gateway/webapps/ROOT/WEB-INF/classes
vi gatewayUser.properties

  4. In the mdm.ip.addresses field, paste the IPs. (Include all Virtual IPs, data IPs for any MDM that may become primary.)

  5. Run the following command to create a lock box and the MDM username and password.

NOTE: The original name of the below script in older versions was SIOGWTool.sh.

/opt/emc/scaleio/gateway/bin/FOSGWTool.sh --set_mdm_credentials --mdm_user <username> --mdm_password <password> --create_default_lockbox

  1. Run the following command to restart the GW service:

    systemctl restart scaleio-gateway

  2. Log in to the PowerFlex Gateway Web UI and do the following steps to the REST GW configuration:

    1. On the menu, click Maintain.

    2. Enter the primary MDM IP, username, password, and LIA password.

    3. Click Retrieve system topology and approve the primary MDM's certificate.

    4. Click Retrieve system topology again and ensure that all the LIA authentications are valid.

    5. Click Test REST configuration.

    6. Click it and enter the username and password.

    7. The information from the MDM is displayed. Ensure that the MDM IPs are available and connected.

    8. Accept all certificates if and when prompted.

  3. Run the following command to disable Secure Remote Services integration on the PowerFlex GW when using PowerFlex Manager:
    NOTE:  If PowerFlex Manager is not being used, skip this step.

    • For VxFlex OS 3.0 and earlier, run the following command:

      grep features.enable_esrs gatewayUser.properties

      grep features.enable_esrs /opt/emc/scaleio/gateway/webapps/ROOT/WEB-INF/classes/gatewayUser.properties

features.enable_esrs=false

    • For PowerFlex version 3.5 and 3.6, run the following command:

      grep features.notification gatewayUser.properties

      grep features.notification /opt/emc/scaleio/gateway/webapps/ROOT/WEB-INF/classes/gatewayUser.properties

features.notification_method=none


The PowerFlex Gateway is successfully redeployed.

Article Properties

Affected Product

PowerFlex Appliance, PowerFlex Software

Last Published Date

09 Dec 2022

Version

8

Article Type

How To

Back to Top