Hitachi Content Software for File v4.0.5.19 Release Notes
About this document
This document (RN-HCSF003-04, May 2023) provides information about the Hitachi Content Software for File (HCSF) software product, including new features, new functions and improvements, fixed issues, and known issues.
Intended audience
This document is intended for customers and Hitachi Vantara partners who license and use Hitachi Content Software for File.
Accessing product documentation
Product user documentation is available on the Hitachi Vantara Support Website: https://knowledge.hitachivantara.com/Documents. Check this site for the most current documentation, including important updates that may have been made after the release of the product.
Accessing product downloads
Product software, drivers, and firmware downloads are available on the Hitachi Vantara Support Website: https://support.hitachivantara.com/.
Log in and select Product Downloads to access the most current downloads, including important updates that may have been made after the release of the product.
About this release
This document describes the differences between the following versions.
Product |
New version |
Previous version |
Hitachi Content Software for File |
4.0.5.19 |
4.0.1.36 |
Release highlights
Release highlights for HCSF versions since v4.0.1.36:
� Added InfiniBand networking support to the 4.0 release.
� Added support for RHEL 8.7 and Rocky Linux 8.7.
Breaking Changes / Deprecation
Not applicable to this release.
New features
Not applicable to this release.
New functionalities and improvements
The following table lists and describes the new features in HCSF versions since v4.0.1.36.
Item |
Description |
WEKAPP-281651 |
New QoS mount option to support controlling the number of client operations Added a new mount option: 'qos_max_ops' that controls the maximum number of IO Operations per second. This value is per mount point and is divided between the frontend processes servicing this mount point. Each frontend process has a minimum limitation of 100 ops/s. If the specified value is lower than the minimum, it is adjusted to the minimum value. |
Fixed issues
The following tables list and describe the fixed issues in HCSF versions since v4.0.1.36.
Clustering
Item |
Description |
WEKAPP-230789 |
Thin-provisioned filesystems in multiple organizations Miscalculation of free space in non-root organizations without an organization quota and thin-provisioned filesystems might lead to failures in creating new (thick provisioned) filesystems in that organization. Configuration: Multiple organizations and thin-provisioned filesystems |
WEKAPP-191222 |
Improved error details when a CPU does not meet requirements. The error message about mount operation failure due to a CPU that doesn't meet the requirements is improved with more information. |
Clustering / Failure Domains
Item |
Description |
WEKAPP-261888 |
Cannot add a drive to a host that's on a different failure domain The system does not prompt a message and does not prevent adding a drive to a host if the drive was previously configured with a different failure domain. The solution includes adding a relevant message and preventing this action. |
Clustering / Rejoin
Item |
Description |
WEKAPP-26708 |
Packet corruptions cause assertion failures on the receiving process. HW error-induced packet corruptions can trigger assertion failures on the receive side. A new behavior prevents the asserts by banning the problematic server. With the Customer Success Team's assistance, you may manually override the restriction by using one of the following arguments: * network_ban_disabled: Change to true or 1 to disable. * network_ban_seconds: The time to ban the problematic server. The time is increased exponentially. That is, network_ban_seconds2^(num_occurrences-1). network_ban_max_backoff_seconds: The maximum time to ban. The ban is remembered in ephemeral (transitory) memory. A server restart of stop/start io causes all elements to forget the last ban state. |
Control / API
Item |
Description |
WEKAPP-285794 |
Fix baseline bug Servers with laggy networking between them to the cluster can prevent the leader from taking some of the cluster management actions, this can be reflected in hanging stop-io, disk updates wouldn't progress, etc. Impact: Cluster management action failures |
Filesystem
Item |
Description |
WEKAPP-279828 |
False reservation of SSD capacity between thin provisioned filesystems SSD capacity is falsely reserved for one thin provisioned filesystem while a different thin provisioned filesystem is filled. |
WEKAPP-289452 |
Pausing a filesystem squash task might cause data inconsistency Filesystem squash task is a task that is started automatically after downloading a snapshot. Pausing this task might cause data inconsistency. |
WEKAPP-294491 |
Default quotas for deleted directories are not removed, they are kept in the default quota's table even though the directory has been deleted. Default quotas for deleted directories are kept in the default quota's table even though the directory has been deleted. |
Filesystem / Capacity
Item |
Description |
WEKAPP-268022 |
IO operations hang when a directory quota reaches its exact value When the directory quota is filled to its exact value, the QuotaHardLimitReached event is not issued, and IO operations to this directory may hang. |
WEKAPP-269936 |
Default quota REST API returns a wrong inode_id Default directory quota listing REST API returns the internal inode ID instead of the external one. |
Filesystem / Clusterwide Tasks
Item |
Description |
WEKAPP-232512 |
Resuming an object-store detach task while it is still pausing Resuming a cluster task ( |
Filesystem / RAID
Item |
Description |
WEKAPP-277972 |
HCSF compute processes crash HCSF compute processes might crash when reading invalid blocks instead of gracefully failing the IOs with an EIO error code (I/O error). |
Interfaces / Driver
Item |
Description |
WEKAPP-276858 |
stat() after file rename |
WEKAPP-23425 |
Negative directory entry cache is not invalidated on hardlinks When using a non-zero |
WEKAPP-254468 |
HCSF driver memory reclamation. Some memory is not marked as cache and is not reclaimed back for other allocations at need. |
Interfaces / NFS / Ganesha
Item |
Description |
WEKAPP-210697 |
Extend NFS interface name characters limit Extended support for NFS network interface device names up to 14 characters long (previously 11 characters). |
Interfaces / SMB
Item |
Description |
WEKAPP-260018 |
SMB service interuption Sometimes, when one of the processes of the SMB service is restarted, it isn't automatically activated back. As a result, users get a |
Platform
Item |
Description |
WEKAPP-257495 |
Upgrade fails due to PKEY interface names parser issue Parsing PKEY interface names has an issue preventing using HCSF alongside a PKEY configuration. |
WEKAPP-270803 |
Incorrect drive states report. The report displays incorrect drive states when running the |
Platform / Network
Item |
Description |
WEKAPP-278557 |
HCSF processes hang after container restart When working with E810 NIC, a container restart might cause the weka processes to hang in a SYNC state. Configuration: E810 NIC |
Upgrade
Item |
Description |
WEKAPP-296788 |
One-shot upgrade failure on clients On one-shot upgrade mode to version 4.1.0, the upgrade will succeed on the backends, but may fail on the clients due to a timeout. |
WEKAPP-277811 |
Clients roll back after upgrade When using the upgrade-clients flag during the upgrade, the clients may roll back to the previous version a few minutes later. |
WEKAPP-280878 |
A race condition may cause a failure during an upgrade A race condition that causes clients' removal may lead to a failure in the upgrade process and not roll back to the source version. |
WEKAPP-277811 |
Clients roll back after upgrade When using the upgrade-clients flag during the upgrade, the clients may roll back to the previous version a few minutes later. |
WEKAPP-280878 |
A race condition may cause a failure during an upgrade A race condition that causes clients' removal may lead to a failure in the upgrade process and not roll back to the source version. |
WEKAPP-278962 |
Upgrade rollback Aborting an upgrade process (pressing Ctrl+C) does not roll back the upgrade process to the original version. |
Upgrade / NDU
Item |
Description |
WEKAPP-296798 |
NDU failure Client (stateless) mounting during NDU might fail the NDU process. The cluster is still up, and IOs continue. |
WEKAPP-269693 |
Filesystem mount hangs after upgrade A filesystem mount performed right after a |
UX / CLI
Item |
Description |
WEKAPP-295566 |
weka cluster nodes called from a client in a lower version weka cluster nodes CLI command fails when called from clients that are on an older version (3.14.3) than the cluster version. |
UX / React UI
Item |
Description |
WEKAPP-283484 |
NFS permissions page does not load in the UI When more than one client group is configured, the NFS permissions page does not load in the UI. |
Known issues
There are no known issues in HCSF v4.0.5.19.
Documentation
This release includes the following user documentation.
Title |
Number and revision |
Issue date |
Hitachi Content Software for File User Guide |
MK-HCSF000-01 |
October 2022 |
Hitachi Content Software for File Command Line Reference |
MK-HCSF001-01 |
October 2022 |
Copyrights and licenses
� 2021, 2023 Hitachi Vantara LLC. All rights reserved.
No part of this publication may be reproduced or transmitted in any form or by any means, electronic or mechanical, including copying and recording, or stored in a database or retrieval system for commercial purposes without the express written permission of Hitachi, Ltd., or Hitachi Vantara LLC (collectively "Hitachi"). Licensee may make copies of the Materials provided that any such copy is: (i) created as an essential step in utilization of the Software as licensed and is used in no other manner; or (ii) used for archival purposes. Licensee may not make any other copies of the Materials. "Materials" mean text, data, photographs, graphics, audio, video and documents.
Hitachi reserves the right to make changes to this Material at any time without notice and assumes no responsibility for its use. The Materials contain the most current information available at the time of publication.
Some of the features described in the Materials might not be currently available. Refer to the most recent product announcement for information about feature and product availability, or contact Hitachi Vantara LLC at https://support.hitachivantara.com/en_us/contact-us.html.
Notice: Hitachi products and services can be ordered only under the terms and conditions of the applicable Hitachi agreements. The use of Hitachi products is governed by the terms of your agreements with Hitachi Vantara LLC.
By using this software, you agree that you are responsible for:
1) Acquiring the relevant consents as may be required under local privacy laws or otherwise from authorized employees and other individuals; and
2) Verifying that your data continues to be held, retrieved, deleted, or otherwise processed in accordance with relevant laws.
Notice on Export Controls. The technical data and technology inherent in this Document may be subject to U.S. export control laws, including the U.S. Export Administration Act and its associated regulations, and may be subject to export or import regulations in other countries. Reader agrees to comply strictly with all such regulations and acknowledges that Reader has the responsibility to obtain licenses to export, re-export, or import the Document and any Compliant Products.
Hitachi and Lumada are trademarks or registered trademarks of Hitachi, Ltd., in the United States and other countries.
AIX, AS/400e, DB2, Domino, DS6000, DS8000, Enterprise Storage Server, eServer, FICON, FlashCopy, IBM, Lotus, MVS, OS/390, PowerPC, RS/6000, S/390, System z9, System z10, Tivoli, z/OS, z9, z10, z13, z14, z15, z/VM, and z/VSE are registered trademarks or trademarks of International Business Machines Corporation.
Active Directory, ActiveX, Bing, Excel, Hyper-V, Internet Explorer, the Internet Explorer logo, Microsoft, Microsoft Edge, the Microsoft Corporate Logo, MS-DOS, Outlook, PowerPoint, SharePoint, Silverlight, SmartScreen, SQL Server, Visual Basic, Visual C++, Visual Studio, Windows, the Windows logo, Windows Azure, Windows PowerShell, Windows Server, the Windows start button, and Windows Vista are registered trademarks or trademarks of Microsoft Corporation. Microsoft product screen shots are reprinted with permission from Microsoft Corporation.
All other trademarks, service marks, and company names in this document or website are properties of their respective owners.
Copyright and license information for third-party and open source software used in Hitachi Vantara products can be found in product documentation, at https://www.hitachivantara.com/en-us/company/legal.html or https://knowledge.hitachivantara.com/Documents/Open_Source_Software.