Pubs HPE Nimble Storage Windows Toolkit Release Notes NWT 7 1 0
Pubs HPE Nimble Storage Windows Toolkit Release Notes NWT 7 1 0
Version 7.1.0
Legal Notices
© Copyright 2020 Hewlett Packard Enterprise Development LP
Notices
The information contained herein is subject to change without notice. The only warranties for Hewlett Packard
Enterprise products and services are set forth in the express warranty statements accompanying such products
and services. Nothing herein should be construed as constituting an additional warranty. Hewlett Packard Enterprise
shall not be liable for technical or editorial errors or omissions contained herein.
Confidential computer software. Valid license from Hewlett Packard Enterprise required for possession, use, or
copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documen-
tation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard
commercial license.
Links to third-party websites take you outside the Hewlett Packard Enterprise website. Hewlett Packard Enterprise
has no control over and is not responsible for information outside the Hewlett Packard Enterprise website.
Acknowledgments
Intel®, Itanium®, Pentium®, Intel Inside®, and the Intel Inside logo are trademarks of Intel Corporation in the
United States and other countries.
Microsoft® and Windows® are either registered trademarks or trademarks of Microsoft Corporation in the United
States and/or other countries.
Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated.
Java® and Oracle® are registered trademarks of Oracle and/or its affiliates.
UNIX® is a registered trademark of The Open Group.
Publication Date
Wednesday November 11, 2020 23:27:04
Document ID
fag1603863714531
Support
All documentation and knowledge base articles are available on HPE InfoSight at https://infosight.hpe.com.
To register for HPE InfoSight, click the Create Account link on the main page.
Email: mailto:[email protected]
For all other general support contact information, go to
https://www.hpe.com/us/en/services/nimble-storage.html.
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 2
NOS
Contents
NWT 7.1.0......................................................................................................4
Special Notes.......................................................................................................................................4
New Features in NWT 7.1.0.................................................................................................................7
Recent Release Features....................................................................................................................8
Documentation.....................................................................................................................................9
Verified Update Paths..........................................................................................................................9
Known Critical Issues.........................................................................................................................10
Resolved Critical Issues.....................................................................................................................10
Resolved Issues.................................................................................................................................10
Known Issues.....................................................................................................................................10
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved.
NWT 7.1.0 Special Notes
NWT 7.1.0
Version: 7.1.0
Revision: Wednesday November 11, 2020 23:27:04
The release notes describe the major changes, fixes, and known issues for this release of the HPE Nimble
Storage Windows Toolkit. They do not include all individual fixes and internal changes.
For technical support, contact HPE Nimble Storage Support at:
mailto:[email protected]
877-3-NIMBLE (877-364-6253), option 2.
Special Notes
Note Description
CRITICAL HPE Nimble Storage continues to qualify configurations between releas-
es. The Validated Configuration Matrix provides information about vali-
dated configurations and is updated frequently. It is a good practice to
check your system configuration against this online tool. The Validated
Configuration Matrix tool is available on HPE InfoSight:
https://infosight.hpe.com/resources/nimble/validated-configuration-matrix
CRITICAL If you are performing either a fresh installation of HPE Nimble Storage
Windows Toolkit (NWT) 7.x.x or upgrading an existing version of NWT
to a 7.x.x version, you might be prompted to reboot your system if you
install the HPE Nimble Storage DSM for MPIO feature.
If you are uninstalling a version of NWT 7.x.x that has the HPE Nimble
Storage DSM for MPIO feature installed, you must reboot your system
when the uninstall operation completes.
CRITICAL An extended data services outage may occur with MS iSCSI initiator
and Intel NICs using the built-in Windows driver e1q60x64.sys (version
11.0.5.21/11.0.5.22).
This issue does not occur with the latest driver from the Intel website.
Tested version 11.17.27.0/12.7.27.0.
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 4
NWT 7.1.0 Special Notes
Note Description
CRITICAL Windows Server 2012 hotfixes are REQUIRED before you install or
upgrade NWT. The hotfixes listed below are the minimum requirement.
The product installer now checks for required hotfixes.
• KB2928678 - Server 2012 update rollup: March 2014, contains
KB2908783.
• KB3102997 - Data is corrupted after iSCSI sessions or paths recover
in Windows Server 2012 R2 or Windows Server 2012.
• KB3046101 - Server may freeze during startup when ALUA-capable
storage is used in Windows Server 2012 R2 or Windows Server
2012.
• KB2964429 - Storage Optimizer memory use increases when it runs
on thin provisioned LUNs.
• KB2996802 - TRIM and UNMAP activities for thin provisioning on
one volume block all activities on other volumes.
CRITICAL Windows Server 2012 R2 hotfixes are REQUIRED before you install
or upgrade the NWT. The hotfixes listed below are the minimum require-
ment. The product installer now checks for required hotfixes.
• KB2964429 - Storage Optimizer memory use increases when it runs
on thin provisioned LUNs.
• KB2996802 - TRIM and UNMAP activities for thin provisioning on
one volume block all activities on other volumes.
• KB4503276 - June 11, 2019 - KB4503276 Monthly Rollup.
CRITICAL Windows Server 2016 hotfixes are REQUIRED before you install or
upgrade NWT. The hotfixes listed below are the minimum requirement.
The product installer now checks for required hotfixes.
• KB4507460 - July 9, 2019 - KB4507460 (OS Build 14393.3085).
CRITICAL Windows Server 2019 hotfixes are REQUIRED before you install or
upgrade NWT. The hostfixes listed below are the minimum requirement.
The product installer now checks for required hotfixes.
• KB4507469 - July 9, 2019 - KB4507469 (OS Build 17763.615).
Important It is recommended that all users of NimbleOS 5.0 or later upgrade all
NWT clients. Also, note that future upgrades to NimbleOS will not work
with NWT 7.0.0 and earlier releases.
Important NWT supports only English versions of Windows.
Important If the VSS Service option is selected in NWT 7.0.2, you must enter array
credentials for at least one Nimble array group during installation.
Important SMI-S is not supported with GST or the multi-protocol feature.
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 5
NWT 7.1.0 Special Notes
Note Description
Important On Windows Servers 2012 and above, the disk optimization process
may record the following error in the application event log:
The volume was not optimized because an error was
encountered: Neither Slab Consolidation nor Slab
Analysis will run if slabs are less than 8 MB.
(0x8900002D)
Although Windows records this as an error in the event log, the event
can be safely ignored for HPE Nimble Storage volumes. HPE Nimble
Storage volumes do not benefit from nor require Slab Consolidation.
Important NCM for iSCSI provides resilient, automated multi-pathing and connec-
tion management for Windows iSCSI environments, even for single array
groups.
Important HPE Nimble Storage recommends the following Microsoft articles:
• KB2964768 – Event ID 150 is logged on a Windows Server 2012 or
Windows Server 2012 R2 Hyper-V host.
Important The NimbleDSM driver for Windows Server 2012/2012 R2, 2016, and
2019 contained within the installation package is certified and signed
by Microsoft.
Important HPE Nimble Storage recommends that you limit the number of snapshot
collection clones created using the PowerShell cmdlets Get-NimDatabas-
eSnapshot or Invoke-NimDatabaseSnapshot to no more than three
at one time. Otherwise the operation might take a long time. The cmdlet,
before it precedes, displays the warning:
This operation will Clone All the Database Present
in this Snapshot Collection. This May take a longer
time.
For example, the following command would require a long time to
complete:
Get-NimDatabaseSnapshot -DBName db1 –MaxObjects 10
–NoReplica | Invoke-NimDatabaseSnapshot
If you entered the same command, but with a smaller value for
-MaxObjects, the operation would complete sooner. For example, the
following command with -MaxObjects 2 takes significantly less time
than the previous one, which specified 10 objects.
Get-NimDatabaseSnapshot -DBName db1 –MaxObjects 2
–NoReplica | Invoke-NimDatabaseSnapshot
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 6
NWT 7.1.0 New Features in NWT 7.1.0
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 7
NWT 7.1.0 Recent Release Features
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 8
NWT 7.1.0 Documentation
Documentation
These Release Notes, the Windows Integration Guide, and other HPE Nimble Storage user documentation
are available on HPE InfoSight:
https://infosight.hpe.com/resources/nimble/docs
You can manually reach the documentation page by logging onto HPE InfoSight and selecting Resources >
Nimble Documentation.
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 9
NWT 7.1.0 Known Critical Issues
Resolved Issues
There are no resolved issues in HPE Nimble Storage Windows Toolkit (NWT) 7.1.0.
Known Issues
HPE Nimble Storage Windows Toolkit (NWT) 7.1.0 has the following known issues.
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 10
NWT 7.1.0 Known Issues
NWT-3767 nwt.cmdlets SQL Instance Application aware cmdlets You must ensure that the
nodes that are such as Get-NimSnapshot, SQL Instance name on the
part of AG must Get-NimDatabaseSnapshot, 2 nodes used for SQL AG
have same in- and so on do not list all the have same name.
stance name for snapshots from both nodes
application if SQL AG is created be-
aware cmdlets tween nodes having differ-
ent SQL Instance names.
NWT-3768 nwt.cmdlets Invoke-Nim- When you set the -applica- At this time, the cmdlet only
DatabaseSnap- tion parameter of the vol- accepts the value SQL2017
shot Cmdlet ume collection information for the- application parame-
Fails When Ar- to SQL2019 and then use ter.
ray-Side Applica- the invoke-NimDatabaseS-
tion Parameter napshot cmdlet to take a
Value Is snapshot, the operation
SQL2019 fails. It reports the following
exception:
Cloning/Snapshot for
Database test@sqlagin-
stance on Array
'XX.XX.XXX.XX' failed with
exception message 'Object
reference not set to an in-
stance of an object.' Invoke-
NimDatabaseSnapshot: Er-
ror While Creating a Snap-
shot of Nimble Database:
Object reference not set to
an instance
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 11
NWT 7.1.0 Known Issues
NWT-3709 nwt.installer Group Manage- Registering the array Group Update to a PowerShell
ment Registra- Management Credentials version greater than 3.0
tion fails during sometimes fails during an before starting the installa-
install/upgrade installation or upgrade oper- tion or upgrade.
when the PS ation if the Powershell ver-
version is less sion is less than 3.0.
than 3.0
This typically happens on
Windows 2008 R2 servers.
It blocks you from complet-
ing the installation.
NWT-3689 nwt.cmdlets Number of snap- The number of snapshots You must be aware of the
shots are differ- in a Snapshot Collection in- snapshot details where the
ent in the snap- voked using Invoke-Nim- database is residing. The
shot collection DataSnapshot differs be- number of volumes must
for replication tween replication partners match.
partners with periodic synchroniza-
tion.
This happens when an SQL
database is configured on
fewer volumes than the
number of volumes that
were configured in a given
Volume Collection.
NWT-3738 nwt.cmdlets/Nim- Metadata on a When you delete an SQL You should always remove
ble VSS Ser- Volume Collec- database that had been and re-create the volume
vices tion Does Not hosted on HPE Nimble collection each time you re-
Get Deleted Storage volumes, the move and recreate an SQL
When the SQL metadata on the volume database on an HPE Nim-
DB Is Deleted collection persists. ble Storage volume.
on the Volumes
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 12
NWT 7.1.0 Known Issues
NWT-1578 Nimble Connec- Nimble Connec- Clicking the "Refresh" but- Not applicable.
tion Service tion Manager ton on the Nimble Volumes
"Refresh" can tab might take several min-
take several utes. The time is dependent
minutes on the total number of con-
nections as well as the oth-
er work the system is doing.
For an idle system, we have
observed three minutes to
complete when there are 40
connected volumes and 250
connections.
NWT-1579 Nimble Connec- Nimble Connec- The NCM GUI is not siz- Use a larger monitor or set
tion Service tion Manager able. Consequently, on the screen resolution to
(NCM) GUI is lower resolution screens, higher value.
not sizable parts of the NCS window
may not be visible on the
screen.
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 13
NWT 7.1.0 Known Issues
NWT-1580 Nimble VSS VSS synchro- CHAP authentication can- Until this issue is fixed in an
Services nized snapshots not be used for VSS syn- upcoming release, the only
cannot use chronized snapshots. authentication mechanism
CHAP authenti- that can be used with VSS
cation synchronized snapshots is
initiator groups.
NWT-3278 NWT VSS Ser- Exchange Snap- The snapshot fails with er- Exclude volumes which are
vices shot fails when ror "Protection set does not hosting incomplete compo-
one Complete contain all the volumes re- nents from volume collec-
and second Par- quired to take application tion and then rerun the
tial Exchange consistent snapshot. Check snapshot.
DB in VolColl the protection set configura-
Example:
tion."
For two mailboxes, MB1
and MB2, and an empty
volume H:(V5):
- MB1 hosts on D:(V1) and
E:\ (V2)
- MB2 hosts on F:(V3) and
G:(V4)
Valid scenario for snap-
shots:
Volume collection of V1, V2,
V5 or V3, V4, V5
Failure scenario: Volume
collection of V1, V2, V3
or V1,V2,V4
NWT-1689 Nimble VSS VSS snapshots VSS snapshots may fail Restart Nimble VSS hard-
Services may fail after re- with ware provider service on
naming volume VSS_E_PROVIDER_VETO the Windows host.
error after renaming one or
more volumes in a volume
collection.
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 14
NWT 7.1.0 Known Issues
NWT-2067 Nimble Windows A copy operation When an ODX copy is at- Do not use pass-thru disks
Toolkit on VM used reg- tempted from a Windows for ODX copy operations.
ular copy in- VM on NTFS volumes that Use direct attached vol-
stead of ODX for are backed by SCSI pass- umes from the Windows VM
a SCSI pass- thru disks from Hyper-V, (iSCSI or FC).
through disk Windows might switch to
(MS regular copy. This is due to
KB3011079) a known Windows limitation
related to MPIO for pass-
thru disks.
See Microsoft KB article
KB3011079 for details.
NWT-2145 Nimble Windows MSiSCSI Initia- Nimble Storage arrays with Understand that when
Toolkit tor or NCM may the VMware VVol feature making iSCSI connections
show targets enabled expose group- using iSCSI Initiator or NCM
without LUNs scoped targets without any to Nimble group targets on
when connected LUNs. These targets will not VVols feature enabled Nim-
to Nimble array be listed as volumes on ble arrays, that iScsiCpl and
with VMware Nimble Storage array GUI. NCM may show the group-
VVols feature However, if Microsoft Win- scoped target as a target or
dows initiators are connect- volume, respectively (for
ed to the same array, this example., iqn.2007-
group scope target will 11.com.nimblestor-
show as a target in iScsiCpl age.com:xyz).
and as a volume (e.g., tar-
get iqn format) in Nimble
Connection Manager
(NCM). No LUNs would ap-
pear under these group-
scoped targets. If Nimble
Connection Service (NCS)
is installed, it may also log
events or log entries about
waiting for disks.
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 15
NWT 7.1.0 Known Issues
NWT-2993 NWT Installer Managing NWT If the silent installation of Install the recommended
silent installation NWT 5.0.0 fails due to hotfixes, which are listed in
failure due to missing Hotfixes on the either this document or the
missing hotfixes host, refer the NWT install NWT install logs.
on the host logs to check the missing
Hotfixes and use the below
command to proceed with
the installation:
Setup-NimbleNWT-
x64.0.0.0.XXX.exe EU-
LAACCEPTED=Yes HOT-
FIXPASS=Yes Re-
bootYesNo=Yes NIM-
BLEVSSPORT=Yes /silent
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 16
NWT 7.1.0 Known Issues
Copyright © 2020 by Hewlett Packard Enterprise Development LP. All rights reserved. 17