Dell PowerFlex 4.6.x Install and Upgrade Guide

Prepare the CSV topology file

Create a CSV topology file when a CSV file and REST API commands are used to deploy block storage. Follow the instructions that match your environment and the PowerFlex support matrix for your version. CSV file templates are provided as part of the software download.

1. In the CSV file, enter your site-specific information in the appropriate places. You can overwrite the default information provided in the file.
   You must only use one spreadsheet for the installation, as follows:
   • To manually enter all configuration details, use the all fields spreadsheet.
   • To use default values for the non-mandatory fields, use the minimum fields spreadsheet.
   • To configure non-default values for columns that are not in the minimum fields spreadsheet, either use the all fields spreadsheet, or copy the column heading from there into the minimum fields spreadsheet, and enter your custom values into the minimum fields spreadsheet.
   NOTE:The examples provided here do not show all possible parameters that are configurable in a PowerFlex system.

   The following figure shows part of a sample an all fields CSV file used to deploy Linux nodes in a hyperconverged system:

   

   The following figure shows a sample of all fields CSV file, where SDCs are defined below the rows for MDMs and SDSs. In a two-layer configuration. The Linux servers form the MDM cluster, and each of those servers will also be SDSs. SDCs can be added here, in separate rows, or added to the system later.

   

2. For Linux nodes, the Domain column is not relevant. Leave the column blank or remove the column.
   The following table describes the fields in the spreadsheets. The required fields appear in both all fields and minimum fields spreadsheets. Field names are case-sensitive; the order of the columns is not significant.

   Table 2. Fields in the CSV fileThe following table describes the fields in the CSV file.

   Field	Description	Required
   Domain	If using a domain user, the name of the domain (not relevant for Linux)	-
   Username	The name of the user. Linux nodes: Enter either root or a non-root sudo user, indicated by appending (sudo) to the end of the username (default: root). For more information about deploying with a non-root user, see Deploying PowerFlex using a non-root user. Windows nodes: Enter a user with administrator rights (default: administrator).	-
   Password	Password used to log in to the node. This should be the password of the user entered in the Username column.	Yes
   IPs	IP address to be used for multiple purposes. Use this field to designate one IP address that will be assigned to all the following: MDM IP, MDM Mgmt IP and SDS All IP. This option is provided for use cases where separate networks for data and management are not required.	-
   Is MDM/TB	The MDM role to deploy on this node: Primary, Secondary, TB, Standby-Secondary, Standby-TB, or blank (if not an MDM). For more information, see the Dell PowerFlex 4.6.x Technical Overview for information about the MDM cluster.	Yes
   MDM Mgmt IP	The IP address for the management-only network. The management IP address is not required for: tiebreaker, standby tiebreaker, and any host that is not an MDM. In such cases, leave this field blank.	-
   MDM IPs	MDM IP addresses used to communicate with other PowerFlex components in the storage network. This is required for all MDMs, tiebreakers, and standbys. Leave this field blank for hosts that are not part of the MDM cluster. Maximum of eight addresses, comma-separated, no spaces.	-
   MDM Name	The name to be assigned to an MDM node, up to 31 characters in length. MDM names must be unique and may not contain spaces. Ensure that each server on which MDM is installed has a unique hostname.	-
   perfProfileForMDM	Optional performance profile to set for MDMs: High (default) or Compact. When this field is left empty, the default option is applied. High performance is required for the fine granularity data layout feature.	-
   Virtual IPs	A virtual IP address (VIP) for each possible manager MDM. This virtual IP address can be used for communication between the MDM cluster and SDCs on the PowerFlex data networks (not applicable for the management network). Only one virtual IP address can be mapped to each NIC, with a maximum of four virtual IP addresses per system.	-
   Virtual IP NICs	The NIC to which the virtual IP addresses are mapped. Maximum length of 11 characters.	-
   Is SDS	Deploy the SDS component on this node: Yes or No	Yes
   SDS Name	The name for the SDS node, up to 31 characters in length. The name must not contain spaces. Ensure that each server on which SDS is installed has a unique hostname.	-
   SDS All IPs	SDS IP addresses to be used for communication among all nodes. Maximum of eight addresses, comma-separated, no spaces. NOTE:When using this option, all roles use the same IP addresses, and there is no need to fill the SDS\SDC only columns.	-
   SDS-SDS Only IPs	SDS IP addresses to be used for communication among SDS nodes. When the replication feature is used, these addresses are also used for SDS-SDR and SDT-SDT communication. Maximum of eight addresses, comma-separated, no spaces.	-
   SDS-SDC Only IPs	SDS IP addresses to be used for communication among SDS and SDC nodes only. Maximum of eight addresses, comma-separated, no spaces. For SDC-only nodes, enter the IP address in this column.	-
   Protection Domain	The protection domain to which to assign this SDS or SDR. The name can be up to 31 characters in length.	-
   Fault set	The fault set for an SDS. NOTE:When using fault sets, you must assign a minimum of three. See the Dell PowerFlex 4.6.x Technical Overview for guidelines on fault sets.	-
   SDS Storage Device List	Storage devices to be added to an SDS. For more than one device, use a comma-separated list, with no spaces. Ensure that the device names and paths do not contain any special characters, such as: ?, `, !, @, # See the Dell PowerFlex 4.6.x Technical Overview to configure direct attached storage (DAS). Device name format on Linux: /dev/sdb,/dev/sdc When specifying the SDS device path on a Linux node, use the path according to how it is listed in cat/proc/partitions (and not according to the output of fdisk -l). Use persistent device names. For example: fdisk output: /dev/mapper/samah-lv1, /dev/sdb cat /proc/partitions output: dm-3, sdb Use these values in the CSV file: /dev/dm-3, /dev/sdb To enable volume creation, you must add (at least) one device to (at least) three SDSs, where each SDS is in a separate fault set. Each device has a minimum of 130 GB free storage capacity (an SDS which has not been assigned to a fault set is treated as a fault set of its own). You can do that using the CSV file, or at a later stage. For the maximum number of devices per SDS, see product limits in the Dell PowerFlex 4.6.x Technical Overview. Device data is erased when devices are added to an SDS. When adding a device to an SDS, PowerFlex checks that the device is clear before adding it. If the device is not clear, an error message is displayed for each device. PowerFlex might not perform optimally if there are large differences between the sizes of the devices in the storage pool—for example, if one device is as big as the rest of the devices. After adding devices, you can define how much of the device capacity is available to PowerFlex by using the SCLI command modify_sds_device_capacity. For optimal performance, try to balance the number of devices of a storage pool, and the capacity of those devices among the relevant SDSs.	-
   StoragePool List	Sets storage pool names, up to 31 characters in length. Use this option in one of the following ways to assign storage pools to the devices in the SDS Storage Device List: A comma-separated list of storage pool names; the length of the list must be the same length as the list of devices in the SDS Storage Device Names list. In this case, the storage pools are mapped to the devices in that list, respectively. The list must be comma-separated, with no spaces. If one storage pool is entered here, the same storage pool are mapped to all the devices in the SDS Storage Device List. If no storage pool is listed, a storage pool is automatically created during installation, named default.	-
   SDS Storage Device Names	Sets names for devices. Assigns device names to the devices in the SDS Storage Device List, respectively. The number of names must equal the number of devices. Comma-separated, no spaces.	-
   perfProfileForSDS	Optional performance profile to set for SDSs: High (default) or Compact When this field is left empty, the default option is applied. High performance is required for the fine granularity data layout feature. For more information, see Configure performance profile during deployment.	-
   Is SDC	Yes or No.	Yes
   perfProfileForSDC	Optional performance profile to set for SDCs: High (default) or Compact. When this field is left empty, the default option is applied. High performance is required for the fine granularity data layout feature. For more information, see Configure performance profile during deployment.	-
   SDC Name	Sets a name for the SDC, with a maximum length of 31 characters. Ensure that each server on which SDC is installed has a unique hostname.	-
   NVDIMM Acceleration Device List	List of NVDIMM devices used to provide acceleration for storage pools using fine granularity data layout. Up to six devices, comma-separated, with no spaces. Ensure that the NVDIMM devices are configured for DAX mode.	-
   NVDIMM acceleration pool List	Sets NVDIMM acceleration pool names. Assigns NVDIMM acceleration pools to the devices in the NVDIMM Acceleration Device List, respectively. The number of NVDIMM acceleration pools must equal the number of devices. Comma-separated, no spaces.	-
   Is SDR	Deploy the SDR component on this node: Yes or No (default). A minimum of two SDRs per peer system must be deployed for the replication feature. SDRs must be deployed on nodes that also contain the SDS component.	-
   SDR Name	The name of the SDR node can be up to 31 characters in length. The name must not contain spaces. Default: empty field.	-
   SDR Port	The port used by the SDR. Default: 11088	-
   SDR Application IPs	The IP addresses through which the SDC communicates with the SDR. When an application writes data, it works with the SDR through these IP addresses. Maximum of eight addresses, comma-separated, no spaces. The same IP addresses can be used for Application, Storage, External. IPv6 is supported.	-
   SDR Storage IPs	The IP addresses through which the SDR communicates with the MDM for server-side control communications. Maximum of eight addresses, comma-separated, no spaces. The same IP addresses can be used for application, storage, external. IPv6 is supported.	-
   SDR External IPs	The IP addresses through which the SDR communicates with peer systems' SDRs. Maximum of eight addresses, comma-separated, no spaces. The same IP addresses can be used for Application, Storage, External. IPv6 is supported.	-
   SDR All IPs	SDR IP addresses to be used for communication among all nodes (including all three roles) Maximum of eight addresses, comma-separated, no spaces. This is the default setting.	-
   perfProfileForSDR	Optional performance profile to set for SDRs: High (default) or Compact. When this field is left empty, the default option is applied. High performance is required for the fine granularity data layout feature. See the Configuring performance profile during deployment topic in related information.	-
   Storage pool Configuration section	Optional section of the CSV file that lets you configure properties for each of the storage pools to which the SDS devices are assigned.	-
   ProtectionDomain	The protection domain to which the storage pool belongs.	-
   StoragePool	The storage pool name	-
   Media Type	The expected device media type in the storage pool: HDD or SDD	-
   External Acceleration	External acceleration type, if used: Read—All devices are accelerated by a non- PowerFlex read cache Write—All devices are accelerated by a non- PowerFlex write cache ReadAndWrite—All devices are accelerated by both non- PowerFlex read and write cache	-
   Data Layout	Data layout type: FG—Fine granularity layout MG—Medium granularity layout	-
   Fine granularity ACCP	The name of the fine granularity acceleration pool associated with the storage pool.	-
   Zero Padding	Zero padding enabled on the storage pool (mandatory for fine granularity): Yes—zero padding enabled No—zero padding disabled	-
   Compression Method	The compression method used in the fine granularity storage pool. Compression methods might affect performance. None—no compression is used Normal—compression is enabled	-
   Replication journal capacity percentage	The percentage of capacity dedicated to the replication journal: a value between 1–100 The percentage is calculated from the net capacity, and not from the total capacity. Use the information provided in the system limits section of system documentation to calculate the percentage of capacity that is required. This calculation also applies to expansion use cases where SDR is being added to an existing system. Each protection domain that contains SDRs should have at least one storage pool with replication journal capacity higher than 0%. Each SDR needs at least 108 GB of replication journal capacity in order to work. Take this into consideration when calculating capacity requirements.	-
   Is SDT	Deploy the SDT component on this node: Yes or No SDT is an NVMe target, which is a front-end component that translates NVMe over Fabric protocol into internal protocols.	-
   SDT Name	The name for the SDT node, can be up to 31 characters in length. The name must not contain spaces.	-
   SDT All IPs	SDT IP addresses used for both hosts communication and MDM communication (including both roles). Maximum of eight IP addresses, comma-separated, no spaces.	-

3. Save the CSV file and retain it for future use.