Skip to main content

We've Moved!

Product Documentation has moved to docs.hitachivantara.com
Hitachi Vantara Knowledge

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 (object-store detach) while it is still in PAUSING state (visible in weka cluster tasks CLI) might cause the task to resume in an incorrect place. This might lead part of the detach task to be skipped, leading to data unavailability.

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
A rare race condition on a loaded client might cause a stat() call to return inaccurate information after a rename.

WEKAPP-23425

Negative directory entry cache is not invalidated on hardlinks

When using a non-zero dentry_max_age_negative mount option, directory entries that become positive due to an hardlink operation do not invalidate negative entries.

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 Permission Denied message when trying to access shares or files through the SMB service.

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 weka cluster drive command.

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 weka local upgrade might hang on the client machine due to the HCSF agent failing to wait for frontend processes to finish starting up.

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.