Dell Solutions Enabler 10.0.0 Release Notes

PDF

New features

The following tables describe the features that are introduced in Solutions Enabler V10.0.

Table 1. Base functionalityBase functionality
Feature name Feature description
Embedded PowerMax File Support is added for embedded PowerMax File. Support includes:

  • a new option -emulation file that replaces the existing -emulation celerra option to list devices created for PowerMax File.
  • Support PowerMax Data Services integration on arrays running PowerMaxOS 10 (6079) and higher. The enhancement allows a PowerMax File caller to use the symclone establish action to establish the clone session on the requested devices and internally terminate them after they have reached the defined state.

Restrictions and limitations:
  • Base control operations on NAS File objects are allowed by PowerMax File via PowerMax File GUI in Unisphere, but not allowed through Solutions Enabler CLIs.
  • Masking operations on NAS File objects are allowed by PowerMax File via PowerMax File GUI in Unisphere, but not allowed through SE CLIs
  • No controls of NAS File objects will be allowed through Solutions Enabler SRDF CLIs. All control of NAS File objects go through the PowerMax File GUI in Unisphere.
  • No controls of NAS File objects are allowed through Solutions Enabler TimeFinder CLIs. All control of NAS File objects go through the PowerMax File GUI in Unisphere.
symcg:
  • Base control operations are blocked on NAS File objects for PowerMax arrays running PowerMaxOS 10 (6079) and higher. Base control operations on the NAS File objects are still allowed using the -emulation celerra flag for arrays running earlier versions of PowerMaxOS.

symdev:
  • SYMCLI users cannot create/modify/delete/control devices created by PowerMax File application for PowerMax arrays running PowerMaxOS 10 (6079) and higher.
  • The base control operations on the NAS File devices are still allowed using the -emulation celerra flag to devices arrays running earlier versions of PowerMaxOS.

symdg:
  • Base control operations are blocked on NAS File objects for PowerMax arrays running PowerMaxOS 10 (6079) and above.
  • Base control operations on the NAS File objects are still allowed using the -emulation celerra flag for arrays running earlier versions of PowerMaxOS.

symsg:
  • Base control operations will be blocked on NAS File objects for PowerMax arrays running PowerMaxOS 10 (6079) and above.
  • Base control operations on the NAS File objects are still allowed using the -emulation celerra flag for arrays running earlier versions of PowerMaxOS.

symaccess:
  • Masking control operations are blocked on NAS File objects for PowerMax arrays running PowerMaxOS 10 (6079) and above.
  • Masking control operations on the NAS File objects are still allowed using the -emulation celerra flag for arrays running earlier versions of PowerMaxOS.
  • NAS File groups (_FILE_) are listed when using the -all flag or when the group name is provided in the symaccess command line.
  • The masking restore operation does not modify or remove the NAS File groups for PowerMax arrays running PowerMaxOS 10 (6079) and above.

symclone:
  • Solutions Enabler symclone control actions are blocked on sessions that are created by PowerMax File caller on the NAS File objects on the arrays running PowerMaxOS 10 (6079).

symsnapvx:
  • SnapVX control actions are blocked by non-PowerMax File caller on the NAS File objects on the arrays running PowerMaxOS 10 (6079).
FILE emulation device management

Online Device Expansion (ODE) is allowed for File emulation devices.

Support is added for embedded Unisphere on arrays running PowerMaxOS 10 (6079) to indicate that it is performing operations on behalf of the embedded PowerMax File.

Dell standard version

Support is added for Dell Standard Version (DSV). This provides an easy way for Dell Customer Support to obtain product versions and provide a better customer experience.

The symcfg CLI is modified to accept a new -dsv option. When specified, this command displays the full Solutions Enabler package version.
Access local unique ID in client/server mode Support is added to obtain the unique ID for the local host when in client/server mode. To support this, the symauth CLI has a new -local option.
Cloud Scale, HA and Performance Requirements Support is added for PowerMax Cloud configurations of dual Embedded guests deployed using an active-passive model.

This support is provided to the PowerMax Cloud environment by making the access TDEVs and recovery devices visible simultaneously to both embedded guests.

Supported vWitness Platform As a result of Solutions Enabler Virtual Appliance (vApp) being deprecated, the vWitness Lock Service Daemon (storvwlsd) is modified to support running on a customer host.
Provide Access to Unisphere-specific Region in SFS Solutions Enabler frees up a 250MB region that was previously set aside for SFS. This is now available for Unisphere to use.
32Gbs FICON Support Support is added to report 32Gb ports for FICON directors when using the symcfg command.
Flash Tiering Service Levels for CKD PowerMax Storage Groups Solutions Enabler V10.0 allows the new Service Levels (High, Medium and Low) to be assigned to CKD SGs, and display the new Service Levels for CKD SGs.
Support for 25GbE NVMeoF via TCP on PowerMax 2500 and PowerMax 8500

Support is added to configure the NVMe over TCP protocol on ethernet ports. This NVMe over TCP endpoint can then be used to make devices visible to a host that supports this protocol for LUN access.

This support allows users to configure an NVMe Host Initiators in Initiator Groups (IG) with an optional host ID for each host initiator NQN.

ACLX design and performance changes for FA RA convergence.
Support is added to support a UUID on all group objects, including SGs, IGs, PGs, and MVs used for masking view operations on arrays running PowerMaxOS 10 (6079) or above. In addition, the number of groups and number of members in each group, the following changes are implemented:
  • Maximum of 8K storage groups can be created.
  • Maximum of 128 child storage groups can be added for each parent storage group.
  • Maximum of 8K Initiator groups can be created.
  • Maximum of either 128 initiator IDs or 128 Child IG names can be added to an initiator group.
  • Maximum of 8K port groups can be created.
  • Maximum of 8K masking views can be created.
CKD Compression. Users can set compression on a FAST storage group with CKD devices and add CKD devices to FAST storage groups with compression enabled on arrays running PowerMaxOS 10 (6079) or above.
Audit Logging Enhancements Enhancements to audit logs improve the consistency of audit log layouts, improve search functionality, and accommodate changes to the audit logging infrastructure for PowerMaxOS 10 (6079) and above.
Enhancements include:
  • Increased length of some audit record fields when written to an array running PowerMaxOS 10 (6079). In particular, the username field is expanded to 60 characters, and the host_nodename and client_nodename fields are expanded to 24 characters.
  • The ability to merge records that have been broken up due to message length.
  • Support more extensive filter capabilities.
  • Filter records based on the agent that generated them, such as Solutions Enabler or uCode.
  • The ability to control whether Solutions Enabler writes audit records to a V3 array using the legacy format or the new format.
  • Support a longer patch value in returned records.
  • When audit records are written by an instance of Solutions Enabler running on an embedded Guest (PowerMaxOS 10 (6079)), the host_nodename and client_nodename fields are written to reflect the type of Guest and Array ID.
GuestOS Container Status During Deployment/ Upgrade/ Recover Procedures Solutions Enabler V10.0 provides a new API that returns the status of GuestOS instances during their Deployment/Upgrade/Recover procedures.
Support for IBM zHyperLink Solutions Enabler V10.0 exports a new flag to indicate ports on the new SLIC supporting zHyperLink protocol on arrays running PowerMaxOS 10 (6079) or higher.
Database Daemon Deprecation Solutions Enabler V10.0 no longer supports the following database daemons:
  • storsrmd
  • stororad
  • storubdd
  • storudbd64d
  • storifmxd
  • storifmx64d
  • storsqld
  • storsybs11d
  • storsybs12d
  • storsybds12.5_64d
  • storsybs15d
  • storsybs15_64d
Gatekeeper Optimization Solutions Enabler V10.0 has a new way of handling long running syscalls that increases the number of clients that can be serviced by a single gatekeeper. This allows you to successfully run Solutions Enabler with only four gatekeepers configured per array.
Solutions Enabler Platform/Feature support deprecation A number of report and control features are deprecated in Solutions Enabler V10.0. For detailed deprecation information, see Solutions Enabler support deprecation .
New API to Return SFS Usage and Quota Metrics A new API function is added that returns storage usage and quota metrics for each of the top-level SFS regions.
Drop DCP support for Juniper Arrays PowerMax arrays running PowerMaxOS 10 (6079) no longer support Dynamic Cache Partitioning.

The support for the Dynamic Cache Partitioning (also known as QOS) feature is removed from PowerMaxOS 10 (6079) and above.

Storstpd does not report QOS (cache partition) related stats from Solutions Enabler V10.0 or higher.

The SPM_CP (QOS) stats category is not reported from PowerMaxOS 10 (6079) and higher.

Cache infrastructure Solutions Enabler V10.0 exports the non-mirrored cache capacity information on arrays running PowerMaxOS 10 (6079) or higher.

The output of the command symcfg list -v is updated to export both mirrored and non-mirrored cache information for arrays running PowerMaxOS 10 (6079) and higher.

The memory option is no longer supported for arrays running PowerMaxOS 10 (6079) and higher and the error "Feature is not available for this microcode level" is returned.

Dell service tag Solutions Enabler V10.0 can now export Dell Service Tag (DST) for arrays running PowerMaxOS 10 (6079) or higher, using the command symcfg list -v.
TDEV limits Solutions Enabler V10.0 supports separate device ranges for normal TDEVs and VVOLs on arrays running PowerMaxOS 10 (6079) or higher. TDEV device numbers start at 1 and end at 65535 (0xFFFF). VVOL device numbers start 65,536 (0x10000) and end at 131071 (0x1FFFF).
Capacity unit From Solutions Enabler V10.0, the capacity report of devices, disks, pools, groups in MBs are removed from all base report CLI displays and corresponding man pages. The default unit of capacity in the CLI report is changed to GB except the command which has default capacity in Tracks.
CloudIQ support As part of the CloudIQ project, Solutions Enabler V10.0 provides an API to allow callers to retrieve OpenSSH proxy IP addresses from arrays running PowerMaxOS 10 (6079) or higher. These IP addresses are used by Unisphere to access the ESRS appliance.
Enhance symsg The command symsg is enhanced to add all the devices that belong to the selected RA group number to an existing SG.

This CLI is modified to accept an optional -rdfg parameter to select the RA (RDF) group number to only add devices to an existing Storage Group that belong to this RA group number.

Maximum RMT entries Support is added for a maximum of 64 remote array entries in RMT table residing on arrays running PowerMaxOS 10 (6079) or higher.
FEC port flag A new port flag is exported to indicate whether Forward Error Correction (FEC) is enabled on a given port on arrays running PowerMaxOS 10 (6079) or higher.
License Processing

From Solutions Enabler V10.0, the legacy FlexLM license files are no longer supported. In addition to this, Solutions Enbler V10.0 no longer supports license installation to arrays running PowerMaxOS versions lower than PowerMaxOS 10 (6079).

NOTE:To install licenses to arrays running earlier versions of PowerMaxOS or HYPERMAX OS, you can only do so from a host with Solutions Enabler V9.x installed.
Flex RAID Starting with PowerMaxOS 10 (6079), changes are made to the internal management of RAID storage.

The command symdisk is modified to accept a new -reliability qualifier to the -dskgrp_summary option to report details about the Reliability state, RAID Group summary state, plus aggregate usable and spare capacity information for spindles within the disk group and individual engines within each disk group for HYPERMAX OS 5977 and PowerMaxOS 5978. The command symcfg is modified to report aggregate Reliability states at the SRP and System levels.

Changes are made to the command symcfg list -v to accommodate PowerMaxOS 10 (6079) and higher reporting of usable (non-spare) and total/available spare capacities in units of disks, relative to disk sizes in each Disk Group.

The command symdev is modified to address the change that RAID Groups (and their members) do not belong to specific Directors or Engines for arrays running PowerMaxOS 10 (6079) and higher.

Table 2. Local and remote replicationLocal and remote replication
Feature name Feature description
Open Minimally Disruptive Migration support (OMDM) A new Data Migration feature Open Minimally Disruptive Migration (OMDM) is introduced to help automate the process of moving applications from XtremeIO, VNX, Unity, V2, DMX and other array vendors to PowerMax 2500 and PowerMax 8500 arrays.
NOTE:OMDM migration requires a short application downtime.
Deprecate TF Mirror, TF VP Snap, TF Snap

A new enhancement is introduced to block the TimeFinder/Mirror and TimeFinder/VPsnap control actions for arrays running PowerMaxOS 10 (6079).

The symclone user options pre-copy, nocopy, and nondifferential are no longer supported for arrays running PowerMaxOS 10 (6079), as symclone sessions on these arrays is always differential.

Platform readiness to support 4k snaps/clones per volume A new infrastructure is provided to support 4k snapshots per device when it becomes available.

Support is added for 256 clones per source device for arrays running PowerMaxOS 10 (6079) and higher.

The command symclone is enhanced to support 256 clones per source device for arrays running PowerMaxOS 10 (6079) and higher.

Support for SnapVX Direct Mapped Architecture A new SnapVX Direct Mapped Architecture (SDMA) is introduced for the local replication for arrays running PowerMaxOS 10 (6079) and higher. The new SDMA architecture allows the symclone to leverage the same sharing infrastructure as SnapVX snapshots, helping Symclone to be as space efficient as SnapVX.

The symsnapvx CLI is enhanced to allow the users to work with SDMA used by local replication for arrays running PowerMaxOS 10 (6079) and higher.

The use of -copy with link/relink copy action is optional on arrays running PowerMaxOS 10 (6079). The symsnapvx link target states report only the Copied or CopyInProgress state for all link/relink actions with and without the -copy flag. The Copied state is used to indicate the data is available on the target device, otherwise the InProgres state is reported.

This CLI is enhanced to report copy progress indication by overloading the existing DEFINE in progress flag when working with arrays running PowerMaxOS 10 (6079) and higher.

SG support for symclone Support is added for the TimeFinder symclone control and query action with SG on arrays running PowerMaxOS 10 (6079) and higher.
NOTE:The Create, Activate, Recreate actions are not supported with SG input.
Emulation Convergence From PowerMaxOS 10 (6079), infrastructure changes allow multiple emulations to run on a single instance. This Emulation Convergence allows optimizing CPU and memory resource usage when different connectivities exist on the same board within the array.
Table 3. SecuritySecurity
Feature name Feature description
OpenSSL OpenSSL used in data encryption, has been updated from 1.0.2l to 1.0.2.zd, which includes bug and security fixes.
ACL Deprecation on PowerMax 2500 and PowerMax 8500

Symmetrix ACLs (symacl) are not supported on PowerMax 2500 and PowerMax 8500 arrays.

Customer access control on PowerMax 2500 and PowerMax 8500 arrays is handled entirely via User Authorization (RBAC, symauth).

NOTE:With the exception of symauth -unique, any invocation of the command symacl against a PowerMax 2500 or PowerMax 8500 array fails with a not supported error.
RBAC Usability Improvements With the deprecation of ACL support for PowerMax 2500 and PowerMax 8500 arrays, improvements are added to RBAC.

The output for the command symauth list -users is modified to omit the obsolete No Effect flag unless the -mode V92 argument is provided.

SSC Access for Unisphere on EEM Guests Unisphere is enhanced to provide functionality formerly available through vApp Manager. To support this, Solutions Enabler V10.0 provides access to Unisphere through a Secure Symetrix Credential (SSC) when running on the EEM guest.
User Identities on Embedded Guests From Solutions Enabler V10.0, users who have explicitly logged onto an embedded Guest (PowerMaxOS 10 (6079)), their user identity now reflects the type of Guest and Array ID.
Access IDs for Embedded Guests

For embedded Guests on PowerMaxOS 10 (6079) arrays, the same Access IDs are generated for both instances of the Guest.

  • Both instances of the Unisphere Guest use the same Access ID
  • Both instances of the SE-MGMT Guest use the same Access ID
  • Both instances of the SE-TOOLS Guest use the same Access ID
  • Both instances of the VASA Guest use the same Access ID

Arrays running HYPERMAX OS 5977 or PowerMax OS 5978, a different Access ID was used for the two instances of each Guest. These Access IDs are used with operations initiated from these Guests.

Access Control for Clone Operations

To support Clone operations, the following improvements are added:

  • Clone operations performed against SGs:
    • The operation is allowed if the user has been granted these rights to both the source and target SGs, or the entire array.
  • For operations performed against devices from a device list, DG or CG:
    • The operation is allowed if the user has been granted these rights to the SG(s) that both the source and target devices belong to, or the entire array.
  • For Clone operations, LocalRep (Local Replication) rights are required.
Table 4. SRDFSRDF
Feature name Feature description
SRDF enhancements

Solutions Enabler V10.0 includes the following SRDF enhancements:

  • Arrays with PowerMaxOS 10 (6079) and above can have a maximum of 2048 SRDF group.
  • Arrays with HYPERMAX OS 5978 or 5977 hybrids only can have a maximum of 250 SRDF group.
  • Arrays with PowerMaxOS 10 (6079) and above can have a maximum of 2048 SRDF groups per director/port.
  • Arrays with HYPERMAX OS 5978 or 5977 can have a maximum of 250 SRDF groups per director/port.
  • Arrays with PowerMaxOS 10 (6079) and above can have a maximum of 65536 devices per SRDF director/port.
  • All supported arrays running Solutions Enabler V10.0 can have a maximum of 65536 devices per SRDF director/port.
NOTE:When creating an SRDF group between two arrays, the largest SRDF group number which can be used is governed by the array which supports the smaller number of SRDF groups. Therefore, when creating an SRDF group between a PowerMaxOS 10 (6079) and HYPERMAX OS 5978, the largest SRDF group number that can be used is 250.
SRDF consistency

When enabling SRDF Consistency CGs, if the CG contains arrays with PowerMaxOS 10 (6079) and above, the enable is only allowed if:

  • All RDF groups are less than or equal to 250
  • Arrays are a mixture of PowerMaxOS 10 (6079), and/or HYPERMAX OS 5978 with fix 105197, and/or HYPERMAX OS 5977 with fix 105197

or

  • At least one RDF group is greater than 250
  • All arrays are HyperMaxOS 6079 and above

or

  • At least one RDF group is greater than 250
  • Arrays are a mixture of PowerMaxOS 10 (6079), and/or HYPERMAX OS 5978 with fix 105197, and/or HYPERMAX OS 5977 with fix 105197
SRDF N-X

From Solutions Enabler V10.0, support is added to replicate to and from existing arrays to and from new arrays running PowerMaxOS 10 (6079) or above.

  • PowerMaxOS 10 (6079) and above -- PowerMaxOS 10 (6079) and above

  • PowerMaxOS 10 (6079) and above -- HyperMaxOS 5978 with fix 105197

  • PowerMaxOS 10 (6079) and above -- HyperMaxOS 5977 hybrids only with fix 105197
Table 5. Events and alertsEvents and alerts
Feature name Feature description
Event deprecation

Events that are specific to Enginuity 5876 or lower are deprecated.

The following events are removed:
  • 1206-1208
  • 1216
  • 1219-1220
  • 1240
  • 1282
  • 1289-1293
  • 1500-1511
Endpoint event

A new event is added to monitor the life cycle of Endpoint objects creation:

  • 1553 - SYMAPI_AEVENT2_UID_ALERT_ENDPOINT_CHANGE
PowerMax System Profiles and Compliance Events These new events are added to monitor the changes to system profile and Config change control window:
  • 1555 - SYMAPI_AEVENT2_UID_ALERT_SYS_PROF_CHANGE
  • 1556 - SYMAPI_AEVENT2_UID_ALERT_CCW_CONFIG_CHANGE
vasa masking view 1263 - SYMAPI_AEVENT2_UID_ALERT_VASA_MV_CHANGE
Event for device capacity change A new event is added to monitor device capacity changes:
  • 1301- SYMAPI_AEVENT2_UID_ALERT_DEV_CAPACITY_CHANGE
SRP events New SRP events are added for arrays running PowerMaxOS 10 (6079) and higher:
  • 1565 - SYMAPI_AEVENT2_UID_ALERT_SRP_RELIABILITY_STATE_CHANGE
  • 1566 - SYMAPI_AEVENT2_UID_ALERT_SRP_FBA_OP_USAGE_PCT_CHG
  • 1567 - SYMAPI_AEVENT2_UID_ALERT_SRP_CKD_OP_USAGE_PCT_CHG
  • 1568 - SYMAPI_AEVENT2_UID_ALERT_SRP_FBA_PHYSICAL_CAP_CHG
  • 1569 - SYMAPI_AEVENT2_UID_ALERT_SRP_CKD_PHYSICAL_CAP_CHG
  • 1570 - SYMAPI_AEVENT2_UID_ALERT_SRP_FBA_EFF_RES_PCT_CHG
  • 1571 - SYMAPI_AEVENT2_UID_ALERT_SRP_CKD_EFF_RES_PCT_CHG
Table 6. ReportingReporting
Feature name Feature description
SAN health reporting and troubleshooting The Symsan utility is enhanced to present relevant SAN related metrics and configuration to end users. The feature is intended to expedite troubleshooting and shorten time to resolution of issues in customer environments thus improving TCE.
Table 7. StatsStats
Feature name Feature description
EM Emulation Stats

EDS and IM emulations have been converged to an emulation known as EM. Solutions Enabler stats are enhanced to populate performance stats related to EM emulation.

Backend Emulation Changes

On PowerMaxOS 10 (6079) and above, spindles are not associated with a specific DA (Director), Interface or SCSI ID (TID). Instead, they are uniquely identified by the Spindle ID and grouped according to Disk Group.

NVMe Over TCP Metrics Support is added for performance metrics for NVMe over TCP (NVMeOTCP) for PowerMax 2500 and PowerMax 8500 arrays.

Stats for ISCSI and NVME are combined to populate common structure as IPIF (earlier ISCSI IP interface), endpoint (earlier ISCSI target) and initiator by NQN (earlier initiator by IQN for ISCSI) for arrays running PowerMaxOS 10 (6079) and higher.

OR/FARA Converged Emulation Stats
The converged OR emulation supports all front-end connectivity and SRDF functionality. There is one OR emulation instance running per director. In PowerMaxOS 10 (6079) and higher, there are 4 independent or stand-alone emulations:
  • OR - Front-end and SRDF interfaces
  • EM - Internal control and management
  • DF - Back-end management
  • EF - Mainframe
The new OR director emulation consists of the following director types:
  • FA - SCSI over FC fabric
  • RF - SRDF over FC fabric
  • FN - NVMe over FC fabric
  • SE - SCSI over GigE fabric
  • RE - SRDF over GigE fabric
  • NE - NVMe over TCP
zHyperLink Stats

For arrays running PowerMaxOS 10 (6079), support is added for zHyperlink (zHL) ports in Mainframe (MF) environment.

zHyperLink (zHL) Read is an ultra-low latency protocol for reading data from the DS8K. zHL Read is a synchronous protocol.

zHyperLink does not replace the legacy zHPF protocol, instead, it complements the zHPF protocol and is used in very specialized conditions.

zHyperLink stats include:
  • Number of READ commands received
  • READS rejected
  • READS accepted and processed
  • Read I/O count
Physical Port Link Error Stats STP is enhanced to populate stat counters associated with link errors on Physical ports.
FlexRAID Stats STP is enhanced to populate stat counters associated with FlexRAID on PowerMax 2500 and PowerMax 8500 onwards.
Cache infrastructure stats STP is enhanced to populate array cache infrastructure stats.
Realtime Director Busy and Duty Cycle Stats

STP is enhanced to report director busy and duty cycle stats on arrays running PowerMaxOS 10 (6079) and higher. These stats are enabled by default.

The following stats are reported as part of diagnostic collection:
  • Director busy
  • Director group duty cycle (128 duty cycle groups per director)
  • Director process duty cycle (128 process per group duty cycle)
The following categories of stats are reported as part of the real-time collection (reported every 5 seconds):
  • Director busy
  • Director group duty cycle (128 duty cycle groups per director)
Backend Pool Stats STP is enhanced to populate stat counters associated with back-end pool.
Report capacity in RDF and Array metrics

STP is enhanced to report array and SRDF metrics in capacity instead of tracks for arrays running PowerMaxOS 10 (6079) and higher.

Arrays running HYPERMAX OS 5977 and PowerMaxOS 5978 still report metrics in tracks and new fields are added to report the capacity in kilobytes.

DAE and Bandwidth stats for DA STP is enhanced to populate DAE stats, and Bandwidth stats for the back-end. With this enhancement, BE PORT stats for arrays running PowerMaxOS 10 (6079) and higher are deprecated.
Performance Metrics enhancements

Solutions Enabler V10.0 introduces new SPM external data structures with only the relevant metrics. These new structures display "_V2" appended to their original names, signifying that they are Version 2 of SPM data structures.

Arrays running PowerMaxOS 10 (6079) and higher only receive these reduced set of stats.


Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\