Known Issues
The following sections list known issues in this release of StorNext, as well as associated workarounds, where applicable:
Note: If you encounter one or more of the issues listed in this section, please contact Quantum Customer Support and report the issue(s) you encountered. Also inform the support representative whether you were able to successfully work around the issue(s) by using the provided workaround. Doing these things will help Quantum prioritize the order in which known issues are addressed in future StorNext releases.
The table below lists known issues specific to the StorNext File System.
|
Operating System |
Ticket Number |
Case Number |
Description/Workaround |
|
All |
54834 |
3505208, 3516356 |
If a file is being copied to the StorNext file system using Windows Explorer and Windows Explorer crashes before it finishes copying all the data, the file might contain data blocks from old, deleted files. This problem occurs because Windows Explorer sets EOF to the size of the file before it writes the data to the file. This leaves a gap of uninitialized data in the file. Note: This problem can also occur with other programs that set EOF beyond the end of data. This problem does not occur if Windows Explorer encounters an error while writing the file; Windows Explorer will delete the partially written file. Workaround: To prevent this problem from occurring on StorNext, you can use the StorNext "client configuration" application's advanced mount option "Restrict Pre-allocation API" on Window systems and the " For more information on this option, see the man page |
| All | 67363 | n/a |
StorNext 5.4.0.x incorrectly allowed the Unix ID Mapping type to be set to none when the Security Model is set to acl. As a result, file systems fail to start when the Unix ID Mapping type is set to none when the Security Model is set to acl. Beginning with StorNext 6, the FSM does not start when this invalid combination of settings is used. Workaround: To prevent this issue, set the Unix ID Mapping to either winbind or algorithmic for any file system where the Security Model is set to acl. You can make the adjustment before or after upgrading. |
| All | 75633 | n/a |
A StorNext NAS client cannot rename a file if the file has the read-only attribute set. This problem only affects StorNext NAS clients. Workaround A StorNext NAS client must remove the read-only attribute before it can rename the file. |
| All | 78082 | 575600 |
If you set the parameter audit=true in the file system configuration file, the result causes all I/O activity, including reads, to be recorded in the mdarchive. This can greatly increase the number of updates applied to the mdarchive which, in turn, increases the amount of mdarchive compaction activity by the FSM. There is one instance where this increased compaction activity caused the mdarchive to grow beyond the capacity of the HA shared file system. Workaround To work around this issue, Quantum recommends you increase the parameter metadataArchiveCache from the default 2 GB to at least 4 GB, but preferably larger when setting audit to true in the configuration file. |
| macOS | 66948 | 322824, 336945 |
If you access StorNext file systems from Apple Xsan clients, then you might encounter I/O error messages in the system log that do not contain details about real I/O errors detected on the Xsan client. Workaround If you encounter the errors on an Xsan client, contact Apple. |
| macOS | 75819 | n/a |
When running older versions of macOS, an Xsan client cannot mount a StorNext File System volume when a cluster name is included in the local fsnameservers file. An unexpected EOF reading reply error is displayed. # xsanctl mount snfs3 xsanctl: unexpected EOF reading reply If you encounter the EOF error on your Xsan client, do the following workaround to prevent the issue. Workaround # 1 Upgrade the Xsan client to the latest version of macOS supported by StorNext. Workaround # 2 If upgrading macOS is not possible and your MDC fsnameservers file includes a cluster name, remove the cluster name (@_cluster_xx or similar) from the mysan.configprofile file before you copy the file to the Xsan client. For example, change: 10.65.181.158@_cluster()
to 10.65.181.158
See Mount the StorNext File System on Xsan 5.0 (or later) for additional information. |
| All | SNXT-2022 | n/a |
File System Pooling includes an email notification feature, which is enabled by configuring SMTP settings using the sntier config command. These settings are saved in a configuration file within the StorNext configuration directory. As part of recent changes to enhance security, the SMTP password in this file is now masked (replaced with ********) when File System Pooling is restarted. However, the email notification program currently interprets this masked value literally, causing authentication to the user's email account to fail. Workaround A script is available to address this issue. Contact Quantum Technical Support and reference Jira ticket SNXT-2022. |
| All | SNXT-2252 | n/a |
When you create a File System Pooling policy in the UUI, the default interval is set to 0 seconds. This causes the sntierd process to trigger the policy in a tight loop, which can impact backend performance. Workaround: Set the schedule to a reasonable interval — at least 5 minutes. |
The table below lists known issues specific to StorNext Storage Manager.
| Operating System | Ticket Number | Case Number | Description/Workaround |
|---|---|---|---|
|
All |
43320 |
1581004 |
File retrieves from media to disk can be suboptimal for fast tape drives like the Oracle STK T10K drives. This scenario can occur when the retrieve event is initiated on a host that is different from the host running the mover process, which requires the use of synchronous direct I/O. Workaround: To work around this issue and achieve optimal performance for both file stores and retrieves with the T10K drives, increase the default I/O size used by the mover process and make the mover process use asynchronous buffered I/O when the use of synchronous direct I/O is not required, using the following steps: Note: This workaround might also help improve the performance of the faster LTO drives by updating the Note: Changes to
|
|
All |
46693 |
n/a |
Executing the command This is due to the Workaround: Ignore the message; to clear-up the process, re-execute the command |
|
All |
47833 |
n/a |
When copying files between media using the CLI command Note: This behavior might cause file data segment distribution to be sub-optimal on the destination media. Workaround:
|
| All | 69265 | n/a |
Your DDMs might experience a timeout if you try to connect to the database. The issue is identified by an error log in /usr/adic/TSM/logs/tac which contains the text: Process fs_moverd on <host> timed out trying to connect to the database. This usually indicates network connectivity trouble. Try increasing the timeout value by setting the connect_timeout value in /usr/adic/mysql/my.cnf. The default setting is 10 seconds so the new value should be larger.
Workaround:
|
| All | 69341 | n/a |
If you have the IBM APFO driver installed and configured, then when you perform an fsmedread operation of a partial tape block from a full tape block, the operation can fail with errno=12. Note: This issue affects all IBM APFO versions 3.0.19 and earlier, and has an impact primarily on disaster recovery procedures. Workaround: To correct this, perform an fsmedread operation without the IBM APFO driver. |
| All | 72993 | 452722 |
When DDM is enabled for non-primary systems, kernel error messages are logged for reservation conflict because the Primary MDC mounts the tape which sets the reservation to itself and the DDM sets the reservation to itself once the tape is ready. This issue causes a benign message in the /var/log/messages file for reservation conflict. Since the unmounting of the tape also resets the reservation back to the primary MDC, this message is generated the next time a DDM (non-primary MDC) accesses a tape. Note: This issue can result in a large amount of log messages on any machine running DDMs. Workaround: To workaround this issue, you can filter and drop the messages so they are no longer logged, as follows. Note: Reservation conflicts that are a problem also produce RAS alerts, so you can also drop these errors. Create the following rules on all DDM clients, based on the OS, to drop the messages from rsyslog: # echo ':msg, contains, "reservation conflict" ~' > /etc/rsyslog.d/ignore-reservation-conflict.conf
# service rsyslog restart # echo 'if $programname == "kernel" and $msg contains "reservation conflict" then stop' > /etc/rsyslog.d/ignore-reservation-conflict.conf
# systemctl restart rsyslog.service |
| All | SNXT-1765 | 825681 |
If metadata restore is interrupted during file system migration or recovery, the FSM process may leave some inodes with the Restoring flag. On restart, the FSM will complete the overall restore operation but leave these inodes with the flag set and incomplete metadata. While no data is affected, this flag is not expected during normal file system operation and will result in an FSM panic when an attempt is made to access the affected files. Workaround: Quantum recommends you perform a cvfsck following metadata restore which will detect this condition. However, if the cvlogs are reviewed and there is no evidence of FSM restart during the restore, then cvfsck can be skipped. If cvfsck reports the presence of the Restoring flag on files, file system restoration should be restarted from scratch by running cvmkfs -r using a fresh copy of metadata archive. |
| All | SNXT-2282 | n/a |
If a Distributed Data Mover (DDM) goes offline during an active data transfer, Storage Manager does not fail over to another available DDM. Instead, it retrieves data from an alternate vaulted media copy. Automatic DDM failover is not currently implemented. This may result in longer retrieval times if a DDM becomes unavailable during transfer. Workaround: There is currently no workaround for this issue. If you experience this issue, contact Quantum Technical Support. |
The table below lists known issues specific to the StorNext GUI.
|
Operating System |
Ticket Number |
Case Number |
Description/Workaround |
| All | 69360 | n/a |
Using autofs to mount a StorNext file system on an MDC is not supported when the same file system also has a native mount point. For example, if the StorNext file system snfs1 is mounted as /stornext/snfs1, then the MDC should not also have an autofs configuration that mounts it on the MDC in another location such as /space/snfs1. Doing so, causes the fsCheckAffinities and fsCheckTsmFilesystemConfig health checks to fail and generate RAS tickets. Additionally, this might cause the StorNext GUI to fail unexpectedly for certain operations. Workaround: There is currently no workaround for this issue. If you experience this issue, contact Quantum Technical Support. |
| All | 69958 | 373823 |
There is a known issue where stripe group expansion using the StorNext GUI can fail and requires manual intervention to restore file system operation. Stripe group expansion allows an additional disk (LUN) to be added to an existing stripe group, growing the file system user data space. The other way to add space to a file system is to create a new stripe group and add this to the file system. When the GUI executes stripe group expansion, it stops the file system, modifies the configuration file and runs cvupdatefs. If cvupdatefs takes more than 5 minutes to complete, the GUI kills the cvupdatefs utility and reports an error. At this point the file system does not start because the configuration file does not match the current state of the metadata. Workaround: To address this issue, you can do one of two things:
In the case that the StorNext GUI attempt was made and hit the 5 minute timeout, file system operations can be resumed by performing the following:
|
| All | 79549 | n/a |
You cannot use the StorNext GUI to configure or modify a policy class with the GOOGLES3 media type. The process fails with an error similar to the following: Failed to create storage policy or some of its attributes, e.g. associated directories and schedules. Failed to update steering parameters for Copy [1] for Media Type [GOOGLES3]. Verify that the Media Type and Media Format is correct for each copy defined on the Steering tab. Workaround: To workaround the issue, Quantum recommends you use the GOOGLE media type rather than the GOOGLES3 media type, not only because the GOOGLES3 media type provides very limited functionality compared to the GOOGLE media type, but also because you cannot use the StorNext GUI to configure or modify a policy class with the GOOGLES3 media type. However, if you have to use the GOOGLES3 media type, then use the CLI fsaddclass command to configure a policy class and the fsmodclass command to modify an existing policy class. |
| All | 80068 | n/a |
The status and capacity monitors for file systems, libraries, storage disks, and tape drives does not display data on the StorNext GUI home page. This issue is caused as a result of missing font RPM packages on your system. Workaround: To workaround the issue, Quantum recommends you do the following:
|
| All | 80600 | n/a |
If you have an open StorNext user interface browser session, then the browser page might flash due to an ICEfaces error. This occurs when the browser page displays partial data rows, empty data, or all the data. Workaround: To workaround the issue, Quantum recommends you do the following:
|
|
Linux |
47954 |
n/a |
The Safari browser becomes unresponsive when you attempt to configure an Email server using the StorNext GUI. Workaround: To workaround this issue, perform the following procedure:
|
|
All |
SNXT-1329 |
n/a |
When you use the StorNext GUI to configure the Timeserver or Pool (located within the Network Time Protocol (NTP) section on the Configuration > System > Date & Time page), and enter multiple comma separated IP addresses in the Timeserver Pool field, and then click Test NTP, the NTP test hangs and prevents you from accessing the GUI. Example of Timeserver Pool Entry 10.65.162.1,10.65.162.2
Workaround: Do the following to workaround this issue:
|
|
All |
SNXT-2278 |
00861871 |
When you use the StorNext GUI to add a new bucket to an existing namespace, the StorNext GUI incorrectly displays all I/O paths as AXR, even when the underlying configuration (verified via fsobjcfg -l) is correctly set to S3COMPAT. Workaround: Use the CLI and execute the following command to add a bucket: fsobjcfg -add -bucket [bucket_name] -namespace [namespace_name]
|
The table below lists known issues specific to StorNext installations, upgrade, HA systems, and other areas.
|
Operating System |
Ticket Number |
Case Number |
Description/Workaround |
|
All |
68849 |
n/a |
After an appliance firmware upgrade, you might be unable to use previously functioning tape devices because the Workaround: To workaround this issue, rebuild the rpm -e lin_taped
rpm -e lin_tape rpmbuild --rebuild /root/lin_tape-1.76.06-1.src.rpm rpm -ivh /root/rpmbuild/RPMS/x86_64/lin_tape-1.76.06-1.x86_64.rpm rpm -ivh /root/lin_taped-1.76.0-rhel6.x86_64.rpm |
|
All |
78382 |
n/a |
Quantum installs a self signed certificate (valid for 365 days) in /usr/cvfs/config/certs/ only when installing a snfs-common RPM and if a preexisting certificate file does not exist. If you use monitoring software (for example, Zabbix), an expired self signed certificate is flagged after it expires. Workaround: To workaround this issue, do the following to update an expired self signed certificate:
|
| All | SNXT-389 | n/a |
The rpm database might corrupt if an rpm operation or a query is unexpectedly interrupted by a signal, reboot, or a system crash on an Xcellis XWD environment in particular, but could also impact a StorNext MDC in a customer-supplied environment and anywhere that the Appliance Controller software or the Unified User Interface (UUI) software runs. Querying the database might result in errors and report that an installed package is not installed. For example: $ rpm -q snfs-server error: rpmdb: BDB0113 Thread/process 7492/140149665155136 failed: BDB1507 Thread died in Berkeley DB library error: db5 error(-30973) from dbenv->failchk: BDB0087 DB_RUNRECOVERY: Fatal error, run database recovery error: cannot open Packages index using db5 - (-30973) error: cannot open Packages database in /var/lib/rpm error: rpmdb: BDB0113 Thread/process 7492/140149665155136 failed: BDB1507 Thread died in Berkeley DB library error: db5 error(-30973) from dbenv->failchk: BDB0087 DB_RUNRECOVERY: Fatal error, run database recovery error: cannot open Packages database in /var/lib/rpm package snfs-server is not installed These query errors could result in the inability to start StorNext or other Quantum services. On rare occasions, you might see corruption of the rpm database after a reboot of the system while an rpm activity occured. StorNext, Appliance Controller, and UUI invoke periodic rpm queries that could be running when a reboot occurs that could lead to corruption. The rpm database corruption is more likely to be seen in the event of an ungraceful reboot resulting from a kernel panic, power outage, or SMITH reset, or upon sending the kill signal to a running rpm command which can happen via systemd as part of a normal shutdown/reboot sequence. Workaround: Run the following command to repair the rpm database: $ rpmdb --rebuilddb
After you rebuild the database, run a query to verify the database is repaired: $ rpm -q snfs-server snfs-server-7.1.1-91E.RedHat7.x86_64 |
| All | SNXT-547 | n/a |
You might see the following error messages when the Rocky 8 kernel first boots: DMAR: [Firmware Bug]: No firmware reserved region can cover this RMRR [0x000000006f760000-0x000000006f762fff], contact BIOS vendor for fixes DMAR: [Firmware Bug]: Your BIOS is broken; bad RMRR [0x000000006f760000-0x000000006f762fff] DMAR: [Firmware Bug]: RMRR entry for device 1a:00.0 is broken - applying workaround Workaround: You can ignore the error messages. Note: Your system might require an updated BIOS from the manufacturer to fix and eliminate the warnings. |
| All | SNXT-1537 | n/a |
If your system is running StorNext version 7.2.0 (or later) and Appliance Controller version 4.1.0, you might receive the following operation failure error when you run the qtmcontroller iscsiadm command, and your card link goes down: Operation failure: Initiator created, but p3p1.100:isca interface link is down, p3p2.100:iscb interface link is down (E-2003)
Workaround: To workaround this issue, run the following Appliance Controller command: qtmcontroller -c iscsiadm network start
|
| All | SNXT-1738 | n/a |
Caution: Before you upgrade to StorNext version 7.2.x, Quantum strongly recommends you review this known issue and applicable workaround. Upgrades on systems originating from StorNext version 6.0.6 or earlier might fail in the pre-upgrade check when upgrading to StorNext version 7.2.0 due to the presence the obsolete rpms openssl098e and tg3 being installed. The following message might appear in the /var/log/DXi/upgrades/Node1.preupgradechk.out or /var/log/DXi/upgrades/Node2.preupgradechk.out log file if these rpms are present: Found unexpected RPMs installed in the system: openssl098e tg3
Note: This issue only affects upgrades to StorNext version 7.2.0 and is fixed in StorNext version 7.2.4. This issue does not impact StorNext version 7.2.2 as that release is only for fresh installations on Xcellis Workflow Director Gen 3 and Xcellis Workflow Extender Gen 3 systems. Workaround: To workaround this issue, run the following commands to manually remove the openssl098e and tg3 rpms, if they are installed prior to upgrading to StorNext version 7.2.0: # rpm -e openssl098e # rpm -e tg3 |
| All | SNXT-2254 | n/a |
When performing an upgrade on multiple Xcellis Workflow Extender nodes within a NAS cluster at the same time, you may encounter the following error messages: Waiting to join NAS cluster timeout while waiting to join NAS cluster Failed to join to NAS cluster Incomplete processing of SNFS NAS packages; Error occurred during processing The following problems have to be resolved before an upgrade: The following nodes are not joined to a NAS cluster: 10.xx.xxx.102 (E-7045) Workaround: To workaround this issue, do the following to performing an upgrade on multiple Xcellis Workflow Extender nodes within a NAS cluster:
This sequence ensures cluster stability and prevents service disruption during the upgrade process. |
| All | SNXT-2279 | n/a |
Xcellis Workflow Director and Xcellis Workflow Extender fail to mount SMB/CIFS shares Workaround: Starting with StorNext version 7.2.0, mounting SMB/CIFS shares on Xcellis Workflow Director and Workflow Extender platforms is no longer supported. This change occurs because Mellanox OFED drivers replace the default cifs.ko kernel module with a dummy module, preventing SMB/CIFS mounts. This behavior is by design and will not be modified in future releases. |
| All | SNXT-2317 | n/a |
The snauditlogs utility does not properly handle file and path names that contain the comma (,) symbol. If a file or path contains the comma symbol, the resulting line in the csv log displays incorrect values in some fields. Workaround: A patch is available. Contact Quantum Support (see Contacting Quantum Support) and reference Jira ticket SNXT-2317. |
| All | SNXT-2500, SNXT-2503 | n/a |
Firmware utilities fail when multiple QLogic or Emulex cards are present; there is a problem with the python3-quantum-firmware-utils-1.0.1-17605.noarch.rpm package that can result in a python stack trace when multiple QLogic or Emulex fibre channel cards are installed in a host. The stack trace occurs when trying to query the cards to report on firmware versions, and will cause the commands in /opt/DXi/firmware to fail. These commands are usually not called directly by users, but by other utilities or scripts, such as upgrade, startup, service.sh menu and collect logs. The stack traces will cause utilities to fail, but will not block startup or upgrade, and can be ignored until the issue is fixed in a future release. Below is an example of an Admin alert on upgrade that can be ignored: <subject_line> Failure detected checking FirmwareBundle updates </subject_line> <email_body> Failure detected checking FirmwareBundle firmware file updates. Please examine /var/log/DXi/upgrades/Node2.upgradeoutput.log for errors and check the firmware status in the FirmwareBundle menu of service.sh. </email_body> The following is an example of the python stack trace found in the Node.upgradeoutput.log file: # /opt/DXi/firmware/fw_showvers.sh BCM not installed. Skipping MLX not installed. Skipping ELX not installed. Skipping Traceback (most recent call last): File "/usr/lib64/python3.6/runpy.py", line 193, in _run_module_as_main "__main__", mod_spec) File "/usr/lib64/python3.6/runpy.py", line 85, in _run_code exec(code, run_globals) File "/usr/lib/python3.6/site-packages/quantum_fw/smc_fwbundle/utils/dump_vers.py", line 92, in <module> exit_val = main(sys.argv) File "/usr/lib/python3.6/site-packages/quantum_fw/smc_fwbundle/utils/dump_vers.py", line 51, in main fwvers = FwVersions() File "/usr/lib/python3.6/site-packages/quantum_fw/smc_fwbundle/utils/fw_versions.py", line 32, in __init__ self._load_version_info(test=self.test) File "/usr/lib/python3.6/site-packages/quantum_fw/smc_fwbundle/utils/fw_versions.py", line 39, in _load_version_info if fwobj.is_current() == NotInstalled \ File "/usr/lib/python3.6/site-packages/quantum_fw/smc_fwbundle/utils/qlgc_utils.py", line 385, in is_current package = {self.get_package(card) for card in card_list} File "/usr/lib/python3.6/site-packages/quantum_fw/smc_fwbundle/utils/qlgc_utils.py", line 385, in <setcomp> package = {self.get_package(card) for card in card_list} File "/usr/lib/python3.6/site-packages/quantum_fw/smc_fwbundle/utils/qlgc_utils.py", line 331, in get_package chip = self._get_chip_type(card_sn) File "/usr/lib/python3.6/site-packages/quantum_fw/smc_fwbundle/utils/qlgc_utils.py", line 255, in _get_chip_type return self[card_sn]['device'][0]['HBA Model'] KeyError: 0 Workaround: There is no workaround for the issue; an updated python3-quantum-firmware-utils package is required to resolve the issue. |
| All | SNXT-2426 | n/a |
When upgrading an Xcellis system from StorNext 7.2.4 to StorNext 7.2.5, the Mellanox ConnectX drivers are not updated. As a result, systems using NVMe over Fabrics (NVMe‑oF) may lose access to NVMe‑oF LUNs. Workaround: If your environment uses Mellanox ConnectX cards with NVMe‑oF and you plan to upgrade, or have already upgraded, from StorNext 7.2.4 to StorNext 7.2.5, contact Quantum Support for a workaround (see Contacting Quantum Support). This issue will be resolved in a future release of StorNext. |
The table below lists known issues specific to the Quantum UUI.
|
Operating System |
Ticket Number |
Case Number |
Description/Workaround |
| All | CON-11364 | n/a |
The CLIENTS page of the UUI displays duplicate clients. Workaround: To workaround this issue, do the following.
|
| All | CON-11386 | n/a |
If your system is running StorNext 7.1.1 or earlier, the label N/A is displayed in the Reserved column when you display stripe group information in the UUI. Workaround: Upgrade to StorNext 7.2.0 or later to display the Reserved value in the UUI. |
| All | CON-11396 | n/a |
When you upgrade the UUI software, the upgrade process might appear to be complete but the Quantum Unified UI Software Upgrade page does not update due to an update-service request that continuously fails with a 404 status code. Workaround: To workaround this issue, execute the following command as root on the node where the UUI is running: /opt/quantum/uui-common/bin/uui upgrade remote -y
|
| All | CON-11487 | n/a |
When you navigate to the Metrics > Performance and Metrics > Utilization UUI page, you might experience a long delay for the page to display properly. Workaround: To workaround this issue, refresh your browser page. |
| All | CON-11504, CON-11505, CON-11506 | n/a |
If you navigate to the Metrics > Utilization page, and attempt to download a Historical Usage graph, the image file for the graph might not display properly. Workaround: Do the following to workaround this issue:
|
| All | CON-11508 | n/a |
When you navigate to the Metrics > Performance and Metrics > Utilization UUI page, you might receive an error when you view a widget in full screen mode and attempt to print or export a data chart. Example Trouble loading Capacity data. Request aborted.
Workaround: To workaround this issue, close your browser window and then reopen a new browser window. |
| All | CON-11541, CON-11542 | n/a |
If you navigate to the Metrics > Performance page, and attempt to save any data graph as a PNG file or a JPEG file, the image for the graph contains a black background with black text, which results in an illegible data graph. Workaround: To workaround this issue, download the data graph in a different format, such as a PDF document, or an SVG vector image. |
| All | CON-11572 | n/a |
When you upgrade the UUI software, the upgrade process might appear to be complete but the UUI login page displays an error, preventing you from accessing and logging in to the UUI. Workaround: To workaround this issue, execute the following command: /opt/quantum/usui/docker/usui-init-cron.sh --force
|
| All | CON-11587 | n/a |
During a fresh installation of the StorNext 7.2 software on the secondary node of an Xcellis system, the UUI Unified Connector client registration is missing after StorNext is converted to an HA pair. On the top navigation menu of the UUI, click CLIENTS to verify the issue; you might notice a client registration for both the primary node and the secondary node. Workaround: If you are missing the client registration for the secondary node, Quantum recommends you perform either of the following options to workaround this issue. Workaround Option 1 As the root user, SSH to the secondary node and execute the following command: systemctl restart unified-connector
Workaround Option 2 Reboot the secondary node. |
| All | CON-11597 | n/a |
In the UUI (Metrics > Dashboards), the error below might appear in your widget when you perform the following steps:
Example of error File System <name of file system> is no longer exist.
Workaround: To workaround this issue, remove the existing widget from dashboard and add a new widget. |
| All | CON-11618 | n/a |
If you install the UUI software on a customer-supplied system, the following error message appears in the ./uui-install.sh script output when the installation completes. Example of error Error: failed to remove gateway config: gateway config empty
Workaround: You can ignore the error message. |
| All | CON-12453 | n/a |
When performing a single to dual-server upgrade and restoring the UUI on the secondary node, all USBE requests may return a 404 error. This affects service availability for components relying on USBE endpoints. Workaround: To workaround this issue, do the following to make the secondary node become the primary node UUI.
Note: If USBE requests return a 404 error, contact Quantum Support (see Contacting Quantum Support). |
| All | CON-12615 | n/a |
In the UUI under System Settings > System Settings, the description of the Stale Endpoint Expiration Days field is not correct. The description appears as: 0 = default expires in 7 days
Workaround: The correct description of the Stale Endpoint Expiration Days field is: 0 = disabled
|
| All | CON-12633 | n/a |
In the UUI under System Settings > Security Settings, the default value of the Automatic User Logout Inactivity Time (minutes) field on a fresh installation is not correct. The value appears as: 60
Workaround: The correct default value of the Automatic User Logout Inactivity Time (minutes) field on a fresh installation is: 15
|
| All | CON-12640 | n/a |
After upgrading, some API Gateway (APIGW) endpoints may continue to display outdated version information for the Unified Connector (UC) and Storage Manager. Workaround: To workaround the issue, do the following: For the Unified Connector
For Storage Manager
|
| All | CON-12658 | n/a |
The Last Errored Jobs functionality does not display an accurate representation of your File System Pooling jobs. Workaround: Use the Jobs or the Job History interface to view an accurate representation of your File System Pooling jobs. |
| All | CON-12661 | n/a |
There is an issue that prevents a LAN client from appearing on the Clients page for up to 20 minutes or more. Workaround: There is currently no workaround for this issue. A fix will be implemented in a future release of the Quantum UUI. |
| All | CON-12685 | n/a |
Users that are specifically assigned the quantum-flexsync-admin role are currently unable to view or browse the contents of the File Browser. When attempting to access the File Browser, the following error is displayed: Unable to get Folder Content: Request failed with status code 403
This issue appears to be related to insufficient permissions associated with the role. Workaround: If possible, assign the user a broader composite role (for example, quantum-admin or quantum-superadmin) that is known to have full access to the File Browser. |
| All | CON-12739 | n/a |
When downloading and extracting the Unified Connector package for Windows Server OS from the Clients > Software Downloads page, you may encounter the following error: Error 0x80010135: Path too long
This occurs because the .msi file within the archive has a file name or path that exceeds the Windows maximum path length limit, preventing successful extraction. Workaround: To avoid this issue, download the Unified Connector package for Windows OS instead. This version contains shorter file paths and extracts successfully on Windows systems. |
| All | CON-12741 | n/a |
When uninstalling the Unified Connector for Windows via the user interface, you may encounter the following warning: The following applications should be closed before continuing the install: Search Start New notification Workaround: You can safely click Ignore to proceed with the uninstallation. This warning does not impact the removal process. |
| All | CON-12742 | n/a |
When installing or uninstalling the Unified Connector for Windows via the command-line interface (CLI), the package downloaded from Clients > Software Downloads contains incorrect script files. Expected files:
Actual files included:
Note: These are intended for Linux systems and are not compatible with Windows. Workaround: To avoid this issue, use the UI for installation and uninstallation on Windows (see Install or Upgrade the Unified Connector). |
| All | SNXT-2031 | n/a |
After upgrading, the UUI browser console may not display any devices upon login. Workaround: Execute the following command to restart the UUI service on the StorNext node where the UUI service is running: systemctl restart usbe
|
| All | CON-12687 | n/a |
Users that are specifically assigned the quantum-alert-admin role are currently unable to remove alerts. This issue appears to be related to insufficient permissions associated with the role. Workaround: If possible, assign the user a broader composite role (for example, quantum-admin or quantum-superadmin) that is known to have full access to alerts. |
| All | CON-13519 | n/a |
In older QBSP software versions of the H-Series or F-Series systems (prior to QBSP version 2.0), the Health status may appear grayed out even when the system is online and healthy; when you navigate to the Nodes UUI page, the health indicator for your node may display an incorrect status. This issue can occur if Controller B is registered with the API gateway. Workaround: To workaround this issue, ensure that Controller A is registered with the API gateway (see API Gateway Registration and Configuration). |
| All | CON-13555 | n/a |
Switching UUI HA primary from one node to another could result in an error if the usbe service had not fully initialized after failover. This issue is caused by the /usr/src/app/var/cache directory not being reinitialized during failover, which causes missing proxy files. Example of error: Can not get nodes: Request failed with status code 500
Workaround: To workaround this issue, use the following command to restart the usbe service and restore functionality: systemctl restart usbe
|
minute read