Applies To:

Show Versions Show Versions

Release Note: ARX version 4.1.1
Release Note

Updated Date: 08/29/2013

Summary:

This Release Note documents the version 4.1.1 release of the ARX software. We recommend this maintenance release for those customers who want the fixes and enhancements listed in Fixes and Enhancements in This Release.

This release is cumulative, and includes all fixes and enhancements released since version 2.7.1. You can apply the software upgrade to 2.7.1 and later. For information about installing the software, please refer to Installing the Software.

Note: F5 offers general availability releases and general sustaining releases. For detailed information on our policies, refer to Solution 8986, F5 Networks software lifecycle policy, which is available on the AskF5 web site, https://support.f5.com.

Contents:

- User Documentation for This Release
- Minimum System Requirements and Supported Browsers
- Supported Platforms
     - New/Updated Certifications
- Installing the Software
     - Upgrading from 2.7.1
     - Configuration Changes
- Fixes and Enhancements in This Release
- Fixes and Enhancements in Prior Releases
     - Version 4.1.0
     - Version 4.0.1
     - Version 4.0.0
     - Version 3.2.2
     - Version 3.2.1
     - Version 3.2.0
     - Version 3.1.0
     - Version 3.0.0
- Required Configuration Changes
- Known Issues
- Contacting F5 Networks

User Documentation for This Release

In addition to these release notes, the following user documentation is relevant to this release.

These manuals are available from the ARX® GUI or CLI. From the GUI, click on the Documentation link in the navigation panel. From the CLI, use the show software command for a complete listing of the ARX manuals, then use the following command to upload the manual from the ARX:

copy software manual-name destination-url

You can also find the product documentation on the AskF5 Technical Support web site, along with an extensive solutions database.

[ Top ]

Minimum System Requirements and Supported Browsers

The minimum supported browsers for the ARX GUI are:

  • Microsoft® Internet Explorer® (IE), version 6.0
  • Mozilla® Firefox® 1.5, and other browsers that use the Mozilla engine

Later versions are also supported, such as IE 7 and Firefox 3.x.

[ Top ]

Supported Platforms

This release supports the following hardware platforms:

  • ARX®500
  • ARX®1000
  • ARX®4000
  • ARX®6000

New/Updated Certifications

No file servers or client machines have been certified for use with the ARX as part of Release 4.1.1. These subsections describe certifications with earlier releases of the software, which also apply to the current release.

New/Updated Certifications in Release 4.1.0

In Release 4.1.0, F5 Data Solutions certified the following file servers and client machines for use with the ARX.

Filers and File Servers

F5 has tested and qualified Data ONTAP Release 7.3 and 7.3.1 for use on the following back-end filers:

  • NetApp, and
  • IBM N Series.

F5 has also tested and qualified EMC DART 5.6 for use as a back-end file server.

Client Machines

F5 has tested and confirmed the interoperability of the following client software with the ARX:

  • Mac OS X 10.5.5 with
  • Thursby DAVE 7.1.2.

Release 4.1.0 also supports photocopier/scanners as CIFS clients. These scanners can use their "Save As" feature to save a scanned image to a file on an ARX share. The ARX namespace must have a security setting disabled through the CLI (with the new cifs anonymous-access command) or the GUI to support this option.

F5 Data Solutions has tested and qualified the following Kyocera photocopiers/scanners:

  • KM-C2525
  • KM-C3232
  • KM-C3232E
  • KM-C4035E

New/Updated Certifications in Release 4.0.0

For Release 4.0.0, F5 Data Solutions tested and qualified the following 10-gigabit-networking devices with the ARX®4000:

  • F5 BigIP
    10GBASE-SR JDS Uniphase XFP F529937700F4
  • Cisco 4948
    Cisco X2 SR 10-gig Module
  • Force 10 S50N
    10-gig SR Module
  • SMC 8708L2
  • Chelsio NIC
    10GBASE-SR Intel XFP MYBG69N90U
  • Extreme 10G4Xa
    10GBASE-SR Intel SR XFP MYBG71G81W
  • Intel NIC
    10GBASE-SR Infineon XPAK 01564948
  • Netgear GSM7328S
    10GBASE-SR Netgear XFP SR AXM751
  • Netirion NIC
    10GBASE-SR Infineon XPAK 01564948
  • Nortel 5530-24TFD
    10GBASE-SR Intel SR XFP MYBG71G81W
  • Nortel 4526GTX-PWR
    10GBASE-SR Intel SR XFP MYBG71G81W
  • HP Procurve 2900
    10GBASE-SR Procurve X2 DE523RQ001
  • HP Procurve 3400
    10GBASE-SR Procurve X2 DE523RQ001
  • HP Procurve 3500
    10GBASE-SR Procurve X2 DE523RQ001
  • HP Procurve 4205
    10GBASE-SR Procurve X2 DE523RQ001
  • HP Procurve 5400
    10GBASE-SR Procurve X2 DE523RQ001
  • HP Procurve 8100
    10GBASE-SR Procurve X2 DE523RQ001

New/Updated Certifications in Release 3.2.1

In Release 3.2.1, F5 Data Solutions certified the following file-server operating systems for use with the ARX:

  • NetApp Data ONTAP Release 7.2.4 for CIFS-only, NFS-only and Multi-protocol
  • NetApp Data ONTAP Release 7.2.5 for CIFS-only, NFS-only and Multi-protocol
  • EMC Celerra 5.5 for CIFS-only, NFS-only and Multi-protocol

New/Updated Certifications in Release 3.0.0

In Release 3.0.0, F5 Data Solutions has certified IBM NAS 500G file servers.

Filers Supported for ARX Snapshots

An ARX volume can coordinate snapshots amongst the filers behind it. This ARX-snapshot feature supports the following filer-software releases:

  • EMC v5.4 or newer, and
  • NetApp Data ONTAP Release 6.5.* or newer. NTAP VFILER is also supported.

All other filers not explicitly listed above are not supported. When the snapshot subsystem attempts a snapshot on an unsupported filer, the error is written to the snapshot-create report and the ARX syslog.

[ Top ]

Installing the Software

For an existing installation, you can upgrade to 4.1.1 from any of the following releases:

  • 4.1.0
  • 4.0.1
  • 4.0.0
  • 3.2.2
  • 3.2.1
  • 3.2.0
  • 3.1.0
  • 2.7.1

For installation instructions, refer to the Upgrading Software chapter in the ARX CLI Maintenance Guide.

This release also includes a new version of firmware for any chassis type except the ARX6000. You can upgrade the firmware during the software upgrade; the instructions in the above manual explain how and when to upgrade the firmware.

Upgrading from 2.7.1

The 3.1.0 release included a new database format and new firmware, described in the subsections below. These changes necessitate additional steps if an ARX crosses from a pre-3.1.0 release to a post-3.1.0 release. This only applies to systems that are upgrading from Release 2.7.1; skip this section if you are upgrading from a later release.

For a Redundant Pair: Additional Reload after the Upgrade

Release 3.1.0 upgraded the policy database, so that it has a different format than the policy database in 2.7.1. In a redundant pair of ARXes, the policy database runs only if both peers are running 3.1.0 or later when the boot process begins. This is a safeguard to allow for a software rollback. For upgrades from 2.7.1, you must therefore reboot the active peer after both peers are fully upgraded to this release. The CLI Maintenance Guide describes the full software-upgrade procedure; this is an additional failover at the end of the process. This causes a brief service outage while the ARX processes fail over.

Firmware Upgrade for All Chassis Types

As mentioned above, this release includes a firmware upgrade for the ARX4000. If you are upgrading from Release 2.7.1, any chassis type requires a firmware upgrade. The 3.1.0+ firmware supports NSM recovery and NSM binary-core files. Instructions for upgrading firmware are integrated into the Upgrading Software chapter of the CLI Maintenance Guide.

Configuration Changes

Once you install the software, refer to the Required configuration changes section, which contains important information about changes you must make before using the new software.

[ Top ]

Fixes and Enhancements in This Release

Release 4.1.1 is a maintenance release that fixes the following software issues:

33694
Two administrative operations often resulted in omTransactionsRaise traps from the ARX: those invoked by the collect and remove-share ... migrate CLI commands, or their GUI equivalents.

34855
If a managed volume with browsing enabled was importing when a process requested the volume's free space, the import slowed noticeably.

31748
UPN support. Added UPN support for NTLM.

29219
The cancel sync files CLI command had an issue with command completion. The syntax below showed all volumes on the ARX instead of the set of volumes in namespace:

cancel sync files namespace volume ?

Now the command shows only the list of volumes from the specified namespace.

 

32965
An ARX-snapshot removal is designed to remove each component snapshot from the ARX volume's file servers. If any file server failed to delete its snapshot, the ARX noted the failure and then removed all records of the ARX snapshot from its database. This made it impossible to delete the file-server snapshot from the ARX. Now the delete-snapshot operation keeps the ARX snapshot as a "sparse" snapshot; the sparse snapshot only includes the file-server snapshot(s) where the delete failed.

30951
EMC Checkpoints fail with error "Unable to find file system ID <FSID #>." It is possible that the query can fail to find the file system ID. The usual cause of this problem is that the management IP address set for the external-filer object does not identify the correct EMC Control Station for the file system. To view a list of file system IDs and names, run the command 'nas_fs -list' on the EMC Control Station's management console. If the file system ID reported in the error message is not in the list, then it is likely that the wrong Control Station IP address is configured for the external-filer.

33126, 33676
Previously, the LED link light did not come on for 100Mbps setting. This issue has been resolved.

33024
In a particular VPU configuration, a share-removal operation could cause volume software to restart and produce a core file. The restart occurred for a volume that shared its VPU domain with 63 other volumes. (You can remove a share with the remove-share CLI command or its GUI equivalent.)

33725
An ARX administrator could not use remote SSH commands if RADIUS was used for administrator authentication.

32595
A shadow volume sometimes failed if it was backed by an NTFS qtree. The problem was that the shadow-copy rule was using NFS to write its database to the qtree. This release uses CIFS to write the shadow-copy database to an NTFS qtree.

34180
If a multi-protocol volume had a non-latin1 character (such as a Japanese character) in its name, the volume software sometimes failed and produced a core file. The failure only occurred if the namespace's NFS-side character encoding was set to "iso-8859-1;" from the CLI, you can set this with the character-encoding command.

33023
The policy engine failed to detect a rare metadata failure that made it impossible to operate successfully. File-placement rules continued to take CPU cycles without successfully migrating any files. The place rules added many messages to the syslog with this statement: "(No policy queue exists for this volume.)." In the current release, all rule processing stops for a managed volume with this failure.

33706
The snapshot manage CLI command had an unclear error message. The error message is clearer in this release.

33194
An NSM-core processor could fail with a rare combination of NLM transactions (from NFS clients) and file-server outages. These combinations no longer cause an NSM failure.

33312
The snapshot manage CLI command (or its GUI equivalent) failed unless it was preceded by a snapshot create operation in the same managed volume.

30414
CIFS clients occasionally hung when trying to get a directory listing in a direct (or presentation) volume. The problem only occurred in large directories hosted by a Windows server behind the ARX.

33217
When a CIFS-only volume on the ARX attempted to import a CIFS share from a NetApp filer, the import could fail due to an NFS security setting on the filer. The failure occurred only for an ARX volume configured for CIFS subshares, and for a NetApp share backed by a Unix qtree. The NetApp's Unix-security setting is now properly ignored by the CIFS-import process.

[ Top ]

Fixes and Enhancements in Prior Releases

The current release includes the fixes and enhancements that were distributed in prior releases, as listed below. (Prior releases are listed with the most recent first.)

Version 4.1.0

Release 4.1.0 included the following fixes and enhancements, also included in this release.

Features

Release 4.1.0 added the following features to the ARX:

CIFS Access-Based Enumeration (ABE) Support
Release 4.1.0 adds CIFS support for Access-Based Enumeration (ABE). If an ARX volume has ABE enabled, its CIFS clients can only see the files that they have permission to read. That is, inaccessible files and directories do not appear in directory listings. This feature is designed to eliminate client curiosity about files and directories that they do not have permission to view.

The following ABE-supporting filers have been qualified for use behind ABE-supporting volumes:

  • EMC Celerra, software version 5.5.
  • NetApp, software versions 7.2.3 and 7.2.5.
  • Windows 2003 R2 SP2.
  • Windows 2003 SP1.

NOTE: For any ABE-supporting volume backed with NetApp filers, the volume's namespace requires a proxy-user with new access privileges. The proxy-user account must belong to the "Administrators" group on each ABE-supporting NetApp share. This is a higher level of access than the "Backup Operator" privileges required for file migrations.

Support for Maximum Age for Kerberos-Machine-Account Passwords
Some Domain Controllers (DCs) support a "Maximum Age" option that you can set for Machine-Account passwords. This is a secret password exchanged between a machine account (such as an ARX-CIFS service) and the DC when the machine/service first joins the Active-Directory domain. By default, the password lasts indefinitely. Administrators have an option on some DCs to set an expiration period, called a "maximum age." If the machine-account password expires for an ARX-CIFS service, the service can no longer use Kerberos to authenticate its CIFS clients.

Release 4.1.0 adds an operation to resolve this issue. For a site where the maximum age is set and about to expire, you can use the cifs rekey CLI command (or its GUI equivalent) to regenerate the key(s) for your ARX-CIFS service(s).

Fixes

Release 4.1.0 fixed the following software issues, also fixed in this release:

30623
A reboot failed to recover an ARX4000 in SSB-degraded mode. SSB-degraded mode means that the PCI connection has failed between the DP and the CP. In this release, the connection recovers after a CLI reload or its GUI equivalent.

32330
The snapshot timeout client-tolerance command is unsupportable in some file-server topologies. The solution to this issue is to automatically generate a suitable timeout value for ARX snapshots, and to deprecate the command.

32086
When an NSM fails in an ARX6000, certain CLI commands and GUI operations hang without ever completing.

31713
When removing a back-end share from a managed volume, a transient connectivity problem with the share's filer can stop the share-removal operation. The share-removal operation now retries for a longer period of time before canceling. (You can invoke a share-removal operation with the no share, no filer, or remove-share CLI commands, or their GUI equivalents.)

32161
Share-removal reports may contain spurious FF ("Found File") entries.

The solution to this problem is to issue a new CLI command, expect change-mfg-date.scr serial-number, where the serial-number is the one on the chassis label. This changes the output of show chassis chassinfo.

32323
Some processes on the SCM or ACM use progressively-more memory, causing the ARX to eventually refuse administrative logins and offer progressively-slower service to its clients.

31240
The ARX supports a single default route; this may be a problem in a multi-VLAN network with a certain firewall configuration.
The new ip route ... per-vlan CLI command allows an administrator to work around this issue. Refer to the CLI Reference Guide for details on this command.

31674
An alarming syslog message, "xsdd_aipc_task: IPC service error 3...," may appear repeatedly on an ARX, often when the ARX is processing a large number of SID translations. This message does not typically indicate a service-affecting problem, so its severity has been downgraded.

31549
The CLI online help does not line up its options with the correct descriptions. For example, the description below should line up with the generic "Text" option instead of the specific "arx.testlab.sg" choice:

my-arx(gbl)# cifs ?
arx.testlab.sg      - Specify the global server hosting this CIFS service.  
cifs.arxsg.com      -
nfs1.test.lab       -
Text<1-128>         -

my-arx(gbl)# 

30912
If an ARX with two internal disks (an ARX1000, ARX4000, or ARX6000) loses both of them, it fails to reboot so that its redundant peer can take over its storage services. The resolution to this issue is a proper reboot and a faster failover.

31805
An NSM processor fails and produces a core-memory file if it receives a particular error from a back-end-CIFS filer. This only occurs in a presentation (or "direct") volume.

32224
The following circumstances lead to progressively-more memory consumption on the SCM or ACM processor, 1.1:

  • a presentation (or "direct") volume uses a managed volume as one of its "filers", and
  • that managed volume is deleted.

The bespd daemon uses up progressively-more memory until it fails and restarts. This daemon's memory consumption is visible in the output of the show system task CLI command.

 

31488
If an ARX4000 NSM experiences certain driver issues, the driver writes an excessive number of repetitive log messages to the serial Console. This slows the performance of the network drivers, and masks useful driver logs.

32089
A DAVE 7.x client application can create an issue when opening directories in an ARX volume: if the ARX has a particular failure while opening the directory, the directory remains open after the DAVE client has left it. A directory in this state cannot be deleted or renamed by other clients.

31804
A pair of NSM processors can unexpectedly fail, causing a failover in a redundant pair of ARXes. This is due to the NSM software's incorrect assertion that an internal-memory buffer (for log messages) has overflowed.

31692
The ARX4000 does not reliably process jumbo frames. (You can enable or disable jumbo frames with the [no] jumbo mtu CLI command.)

Version 4.0.1


Release 4.0.1 included the following fixes and enhancements, also included in this release.

 

Features

Release 4.0.1 is functionally equivalent to Release 4.0.0. Unlike Release 4.0.0, this release has been fully qualified for use on the ARX®6000 as well as all the other ARX platforms.

Fixes

Release 4.0.1 fixed the following software issues. These fixes are also included in the current release:

32049
The ARX does not re-create its error.log or fastpath files if an administrator deletes one of them. (You can delete these files with the delete logs error.log or delete logs fastpath CLI commands, or their GUI equivalents.)

30720
If an ARX runs active VPUs on both redundant peers (configurable only on earlier versions of ARX software), the CLI or GUI may show incorrect used-file credits for those VPU(s).

31162
An NFS-access list with more than 128 IP addresses can cause the ARX to repetitively reboot if it is used in a presentation (or "direct") volume's attach point.

31255
The ARX4000 allows the Control Plane to power up when the Data Plane is powered off and/or disconnected. This is an unsupported configuration that causes a software loop and prevents the ARX from fully booting.

31483
If a client reads or writes a file with a particular byte sequence through an ARX4000 VIP, the ARX stops processing client traffic.

Version 4.0.0


This section describes the features and fixes from Release 4.0.0. Sites that upgrade from Release 3.2.0 and earlier get the benefit of all the features and fixes described here, in addition to the features and fixes described above.

 

Features

Release 4.0.0 adds the following features:

ARX®4000
Release 4.0.0 supports the new ARX®4000 hardware platform, which is a 4U device with 10-gigabit interfaces. The ARX®4000 has storage capabilities equal to an ARX®6000 with 2 ASMs and 2 NSMs. This platform supports a total of 10Gbps throughput.

Passive LACP
The Link Aggregation Control Protocol (LACP, defined in IEEE 802.3ad) dynamically manages the member ports in a channel. For example, if a configuration change disqualifies a port for channel membership, LACP processes automatically detect the change and stop using the port in the channel. Release 4.0.0 supports passive LACP, which you can configure with the lacp passive CLI command. Refer to the Layer-2 chapter in the CLI Network Guide for details on LACP and LACP configuration.

Fixes

Release 4.0.0 fixes the following software issues:

27757
Deploying switches via template doesn't work with configuration order.

28613
Major inconsistencies revolving around the volume hosting home directories.

28647
When l2 failed on the senior switch, it detected a remote metalog error and causes the junior switch to fail. Since the senior is already rebooting due to the l2 failure, this causes a dual reboot.

29154
Cannot identify volumes using namespace-level metadata.

29416
CIFS AD forest names and Windows domain names are case-sensitive and should not be.

29417
GUI virtual services page does not display "joined" when no exports exist.

29450
A planned ARX reload during a large NTP-time skew can result in an unplanned reboot later.

29454
Remove-share nomigrate incorrectly requires "force" on failed import share. The "remove-share nomigrate" command used by the GUI and from priv-exec at the CLI required the "force" option to remove a share that failed import.

29565
A global server that references only disabled volumes can consume 99% of the CPU.

29667
Scripted creation of a VLAN in the ARX4000 CLI may fail.

29704
Policy is unable to move files from one share to another. When looking at the shares in the managed volume, freespace is being reported correctly, yet when a place rule is enabled, policy is unable to move files.

30269
Can't find active partition in config file.

30454
On the ARX4000, if the data plane is powered up after the control plane, the reload CLI command reboots the control plane but not the data plane.

30296
Cryptic error message needs to be more helpful. Superfluous text removed.

30301
Under cifs-service, the vol-path in the exports command is case-sensitive.

30343
If an NSM core has failed, nsm recovery is disabled, and you create a new CIFS service, the service cannot get past the "Starting" state.

Version 3.2.2

This section describes the fixes from Release 3.2.2. Sites that upgrade from Release 3.2.1 and earlier get the benefit of all the fixes described here, in addition to the features and fixes described above.

33883
The customer tried to move subshares to a Windows cluster share farm using the GUI in the ARX. This resulted in the files showing up with 0 bytes and not being accessible (permissions issues). This issue was fixed to provide the necessary subshare handling.

33903
A CIFS-only volume sometimes imported directories with case collisions. For example, a volume imported directory named "myDir" from share A and another directory named "MYDIR" from share B, both directories appeared in the CIFS volume. These directories had a case collision, so neither of them was accessible to clients. The latest release renames the second directory if directory renames are allowed, or it appropriately fails the import otherwise.

28295
In some unusual circumstances, a filer may take more than 75 seconds to complete a create-file request. This may cause files to appear on the back end that are not recorded in the ARX volume's metadata. If a CIFS client creates the same file during this lag time, the syslog shows a STATUS_OBJECT_NAME_COLLISION error and the ARX sends a vcifsNameCollision SNMP trap. A CIFS volume with auto sync files enabled now also automatically updates its metadata with the new file.

31524
The following circumstances can cause dual-NSM-core failures in two ARXes:

  • redundancy is enabled between the ARXes,
  • their quorum disk is an NFS/UDP share,
  • the NFS filer for the quorum disk is unreachable, and
  • the same NFS filer contains shares used for NFS/UDP storage.

 

34042
A file-placement rule promoted stripe directories to "master" status during a concurrent rule's volume scan. This occurred when the directory-promoting rule had volume-scan disabled. The concurrent place rule was on the same schedule and did perform volume scans. With this fix, the directory-promoting rule only promotes directories in response to an inline change, not in response to another rule's scan.

34227
When a CIFS client requested a list of snapshots from an ARX volume, an NSM processor lost a small amount of memory. Eventually, the NSM processor failed.

32057
Under extremely rare conditions the NFS Network Lock Manager (NLM) daemon crashed, triggering an ARX to ARX failover. This occurred when multiple NFS clients canceled lock requests simultaneously.

34446
When internal logging software was blocked with a rare failure, administrative access was frozen. Administrators could not log onto the ARX to resolve the issue. Now, administrators can log onto the ARX and correct the problem if this rare failure recurs.

34771
A direct (or presentation) volume could not attach to an NFSv3/UDP export unless the export also supported NFSv2. Direct volumes can now attach to NFSv3/UDP exports whether or not the exports also support NFSv2.

32165
The memory utilization is reported incorrectly for the ASM board of the ARX6000. As a result, when memory utilization is high it is possible for the active switch to failover to the standby switch before sending any memory utilization SNMP traps.

32262
In some cases, NSM processes incorrectly terminated filenames in their syslog messages. Now the NSM terminates all filenames correctly.

32401
The find command succeeds only for volumes in the first-configured VPU domain; it fails for volumes in all other VPU domains.

32518
Some ARX6000s shipped with incorrect serial numbers on their labels. The show chassis chassinfo command displays the correct serial number. The incorrect values are in digits 3-6, which represent the month and year of manufacture.

32540
In some cases, a scheduled snapshot failed without notification.

34657
A share farm with auto-migrate enabled reserved progressively-more memory, until volume software eventually failed and produced a multi-Gigabyte core file. This memory leak is fixed in the current release.

32608
The volume freespace count on the volume detail page of the ARX GUI is reported incorrectly for values larger than terabytes.

33370
Some rare failure scenarios caused a memory leak in NSM processors, leading to eventual NSM-core failures. The causes included:

  • a failed redundancy link, and
  • an overload of TCP packets to be forwarded to a file server.

 

32816
The ARX sent frequent nsmResourceThreshold traps when the "probuf" resource exceeded 80% utilization. That level of utilization is not unusual, so the threshold for the probuf resource is now 100%.

32653
When a tier 2 NFS filer is slow in responding to client requests from the ARX the performance of ARX operations on tier 1 files may be impacted. Under certain conditions metadata inconsistencies may be introduced.

32849
If two or more CIFS clients repetitively deleted and re-created the same file in a managed volume, the volume spuriously reported a metadata skew for the file. The volume lost track of the file's state. If it happened often enough, the volume's performance suffered.

32940
An additional log message "SSB_LIB_PCI_WORD_WRITE_ERROR" is needed to provide possible early warning for potential hardware issues.

32996
When using MS-RPC to close a file on the ARX, an NSM may experience memory corruption if there are other in-flight operations on that file. This results in the peer NSM processor taking over service.

33037
When a configured name server is unreachable, a domain-join operation sometimes failed due to a timeout.

33459
An internal NFS fault occasionally caused an NSM core to fail on a busy system. The underlying fault is now corrected.

33425
A file-placement rule could remain in an "Initializing" state indefinitely if someone changed its priority during a volume scan. This also affected any other rules running on the same schedule. Now the volume scan may restart or continue, as appropriate; it does not pause indefinitely.

33842
On an ARX with a large number of CIFS Query-Path Info (QPI) requests, an NSM processor occasionally failed. QPI processing is enabled by default in every CIFS-supporting volume, with the cifs path-cache

33057
Volume software could potentially fail and produce a core file when a CIFS client closed a file. This only occurred if the file closed during a filer outage, and the client software had to repeat the directive to close the file. With the current release, the ARX software properly coordinates all "close" requests from its CIFS clients, whether or not they are repeated.

Version 3.2.1

This section describes the features and fixes from Release 3.2.1. Sites that upgrade from Release 3.2.0 and earlier get the benefit of all the features and fixes described here, in addition to the features and fixes described above.

Features

Release 3.2.1 decreases failover times from an ARX to its redundant peer. The decrease is most-noticeable in ARXes with large configurations (that is, many namespaces, volumes, and/or front-end services).

Fixes

Release 3.2.1 fixed the following software issues. Fixes for these problems are also included in the current release:

32597
The output of the show statistics migration CLI command measured its "Average Data Rate" in bits-per-second instead of bytes-per-second. The units shown (such as "MB/s") indicated that the measure was in bytes-per-second. The field now correctly displays its data rate in bytes-per-second.

32043
If a filer's multi-protocol (NFS and CIFS) directory contains more than 1,024 files and subdirectories whose NFS names (such as "file?.txt") differ from their CIFS names (like "file~1.txt"), an ARX-managed volume is excessively slow to import the volume. Clients cannot access the volume until the directory finishes importing.

32031
A domain controller that is slow to respond to the ARX's Kerberos-authentication requests can lead to an eventual outage for the ARX's CIFS clients.

32174
When the CIFS-path cache is very busy, it creates excessive log messages and may send an unnecessarily-alarming nsmResourceThreshold trap. (You can activate this cache for an ARX volume with the cifs path-cache CLI command.)

32402
When a failed migration appears in the output of show policy history, the file name (including the full path) appears twice.

32083
A failover from an ARX6000 to its redundant peer is unnecessarily lengthy.

31832
The collect CLI command, when used to create a local copy of a diagnostics file, uses twice as much internal disk space as necessary. If the diagnostics file is very large, this could potentially fill the ARX disk and cause an unplanned reboot.

32245
The at ... report report-name command produces reports that are not displayable by the show reports command.

32645
If a shadow-copy rule was disabled in the middle of a run, it sometimes deleted directories behind the target (shadow) volume.

32105
The ARX sends the SNMP trap, kerberosCacheRaise, when an internal cache is 85% full. 85% is not sufficiently full to raise an alarm. The solution to this problem was to send progressive kerberosCacheRaise traps when 90% full, then 95%, 98%, and 100%.

30363
If a CIFS application opens numerous Find-Files queries without properly closing them, the open queries can lead to a slow memory-allocation buildup and eventual ARX failure.

31289
A presentation (or "direct") NFS volume reports incorrect free space.

31475
A managed volume prematurely disconnects from an unresponsive back-end filer. If the filer connection improves, this unnecessarily extends the time that ARX clients cannot access the filer's storage.

31905
If a client modifies a directory's attributes and then deletes it, any file-placement rule fills its "inline notify cache" with unnecessary entries about that directory. The rule cannot process legitimate inline notifications (that is, notifications of file changes by the volume's clients) during this time. This also results in excessive, unnecessary messages in the syslog.

31937
When a file-placement rule attempts a directory-rename operation that would exceed a NetApp filer's disk quota, it repeats the failed-rename attempt indefinitely.
A directory rename may use additional disk space if the rename moves the directory to a new parent directory (for example, \dirA\myDir is renamed to \dirA\dirB\dirC\myDir), and one of these conditions also exists:

  • The new parent directory (\dirA\dirB\dirC) exists on one back-end share, but not on the NetApp share, so the ARX must create the parent directory (a stripe of \dirA\dirB\dirC) on the NetApp share.
  • The new parent directory already has a large number of entries (files and subdirectories), so the NetApp file system must request more disk space to store this subdirectory entry.

 

31913
The policy engine may halt in a managed volume with a large database. When this occurs, the following message appears in the ARX syslog: "Lock table is out of available locks." The policy engine does not process any rules while this condition persists.

32147
When a place rule attempts to migrate a file that is too large for the target share's q-tree quota, but is small enough for the overall back-end volume, the rule retries the migration continuously. This prevents smaller files from migrating.

31431
Downgrading from a 3.aa.bbb release to a pre-3.0.0 release triggers a re-import of all managed-volume shares on the ARX. This only occurs in a redundant pair of ARXes, where the peer is still running the pre-3.0.0 release. This can occur during an unsuccessful upgrade.

31218
A multi-terabyte file migration may stop before finishing.

31542
A failure in the snapshot software can cause the ARX to reboot.

31505
The snapshot manage command, which sends filer-specific-CLI commands from the ARX to its back-end filers, causes the ARX to reboot if it receives an unexpected response to those commands.

31429
A managed volume may lose its NFSv3/TCP connection while importing from an EMC Celerra.

31823
An NSM processor may fail and produce a core file on a busy ARX. The following CIFS-client session may trigger this error condition:

  1. The CIFS client connects to an ARX volume,
  2. fails to authenticate with Kerberos, and then
  3. leaves the CIFS connection idle until it times out.

 

31736
A managed volume with an NFSv3/TCP share on an EMC Celerra may spuriously mark the share "offline" if the share is accessed over a WAN or VPN.

31118
A CIFS volume may create a hidden-subshare name (for example, "_acopia_dir5_3$") on a back-end filer, and then record it incorrectly in its database. The volume is then unable to find the back-end subshare(s). This only occurs for subshares that are exported with the hidden or expose-hidden option.

31980
A Windows-Vista client cannot create shortcuts to a subdirectory in an ARX export.

32141
Frequent ARX-share additions to a front-end-CIFS service can put the CIFS-volume software into an unstable state. In this state, the CIFS-volume software periodically restarts and writes a core-memory file.

31440
The following CLI command (or its GUI equivalent) causes continuous reboots if the path-to-exclude contains contains both wildcards and UTF-8 characters:

path match not path-to-exclude ignore-case

This is related to bug 30064, which was fixed in an earlier release.

 

31211
A multi-protocol (CIFS and NFS) volume does not support NTFS qtrees as back-end shares if they run on NetApp Release 7.2.4.

31725
If NFS clients try to mount an ARX volume with NFSv2/TCP, the volume's performance is slow for all NFS clients.

31981
A CIFS volume may stop and restart if its clients have thousands of files open while an MMC (or similar) client is listing its open files.

31506
If a CIFS client attempts to access "\\vip\C$\~snapshot" in a namespace that supports both Windows management (MMC) and snapshots, the namespace software fails. The "C$" share is a virtual share offered for Windows-management access (for example, through MMC). The "~snapshot" directory is a virtual directory for accessing snapshots within an actual share, but does not offer any snapshots in the virtual "C$" share.
For example, suppose the volume(s) in a CIFS namespace is/are shared through a CIFS service at 192.168.25.15 (a virtual-IP address, or VIP). If a client maps the "G" drive to \\192.168.25.15\C$ and then starts working in the "G:\~snapshot" directory, the namespace behind the 192.168.25.15 VIP fails.

Version 3.2.0

This section describes the features and fixes from Release 3.2.0. Sites that upgrade from Release 3.1.0 and earlier get the benefit of all the features and fixes described here, in addition to the features and fixes described above.

Features

Release 3.2.0 added the following features:

Microsoft Windows VSS for Shared Folders (or Previous-Versions) Support for ARX Snapshots
Windows offers an interface called Volume Shadow-copy Service (VSS) for Shared Folders (called "Previous Versions" in Windows Vista) for accessing snapshots. Clients can select a file or directory from their Windows Explorer, pull up the Properties sheet, and click on the Previous Versions tab. This tab displays all snapshots for the chosen file or directory. As of Release 3.2.0, a managed volume that supports snapshots can offer them through VSS.

Automated Controls for CIFS-Accessible File/Directory Names Ending In "." (28630)
Trailing spaces and periods (for example, "myFile.txt." or "myDirectory ") are illegal for most implementations of CIFS, though they are supported by the file system under Windows. Some CIFS vendors convert any file or directory names with trailing periods into Filer-Generated Names (FGNs). In Release 3.2.0, a managed volume probes its back-end shares for this behavior and prevents any trailing-period names from migrating to those shares. Refer to the CLI Maintenance Guide for more information on illegal trailing characters in CIFS volumes.

ARX Secure Agent Support for 64-Bit Windows 2003 DCs
The ARX Secure Agent (ASA, described in Secure Agent Installation) now runs on 64-bit Windows 2003 DCs. There are no functional changes to the ASA.

Fixes

Release 3.2.0 fixed the following software issues:

30688
NSM runs out of memory and crashes.

28834
If a CIFS client joins a new Windows group while connected to an ARX-CIFS service, the client must disconnect from the ARX service and remain disconnected for at least 10 minutes to get the group's access permissions.

29426
The standby ARX sends redundant Kerberos-DC traps (kerberosDCOffline and/or kerberosDCOnline) after the active ARX already sent them.

30874
The snapshot manage command causes the ARX to reboot if it runs on a CIFS volume with a particular configuration issue. The issue is that the actual share name (for example, "MYSHARE") has different case from the one defined in the ARX volume (for example, "MyShare"). In the CLI, you define the share name with the gbl-ns-vol-shr filer command.

30870
Microsoft-Explorer users cannot write to an empty Properties -> Summary tab for a file or directory in an ARX volume.

30679
The GUI allows only 64 bytes in the name of a front-end-export, while the CLI correctly allows up to 1,024 bytes.

30887
If a file-placement rule has spaces in its name, its report name does not have quotation marks ("") around it in the global-config. Without the quotation marks, the report command fails when you run the global-config in the CLI.

30283
If a shadow-copy rule's configuration changes while it is running, the rule pauses indefinitely.

30393
A shadow-copy rule, under rare circumstances, causes a shadow-database corruption at the shadow volume.

30982
If a tentative file-placement rule has a share farm as its target, the rule causes all newly-created files in the share farm to gravitate to a single back-end share.

30480
If you perform a no share or no filer command using the force argument and omitting the remove-file-entries option, all files on the removed share remain in the volume's metadata. This leaves the files visible to clients even though they are inaccessible.

30078
On the originally-junior switch in a redundant pair, you cannot disable or enable a virtual service from the GUI's Virtual Service summary screen.

30497
The ARX is not sending shareOnline traps for NFS shares with import errors.

30813
A volume with the cifs path-cache feature may fail and produce a core file.

30815
Given the following circumstances, an ARX-CIFS volume fails and produces a core file:

  • two back-end shares ("SHARE_A" and "SHARE_B") have subshares whose paths differ only in case (for example, "\\SHARE_A\topDir\nextDir" and "\\SHARE_B\TOPDIR\NEXTDIR"),
  • both subshares are exported with the same share name ("NEXTDIR"),
  • both shares ("SHARE_A" and "SHARE_B") are imported into the same ARX volume, and
  • the ARX volume has filer-subshares enabled.

The volume failure occurs on import if filer-subshares is already enabled before the import, or when filer-subshares is activated later on the already-running volume (for example, with the cifs export-subshares CLI command).

 

30917
If you disable a share in a CIFS volume with filer-subshares, you cannot re-enable the same share later.

31102
Windows Explorer's VSS for Shared Folders (or "Previous Versions") feature does not function in a CIFS subshare exported from the ARX; no snapshots appear under the "Previous Versions" tab in Windows Explorer.

30830
The GUI's Collect Diag-Info operation (invoked with an action button on the Maintenance screen) does not create a "cli_show.log" file.

30839
Changes to the quorum-disk configuration, such as a change in the IP address of the quorum-disk filer, do not take effect.

30409
Multi-protocol managed volumes do not support EMC file systems with an "accesspolicy=MIXED" setting.

29560
A file-placement rule does not recover from the "Failed" state if the volume stops in the middle of a placement run.

29534
If an ARX volume has a CIFS metadata share, client access is slowed by removing a storage share from the volume (for example, with the remove-share CLI command).

30515, 30462
A remote processor times out waiting for a "watchdog" response from an ASM processor, resulting in an unplanned reboot (and, in a redundant pair, a failover).

29725
You cannot stop and restart the GUI on the backup switch in a redundant pair.

30064
A path or match CLI command can cause continuous reboots if you use both of the following in the command string (or the its GUI equivalent):

  • the optional ignore-case flag, and
  • a wild-card string that contains UTF-8 characters.

 

30086
A CIFS managed volume with cifs path-cache enabled may create malformed Query-Path-Info packets for named streams. A CIFS client can only trigger these malformed queries in a front-end share of a subdirectory (not the root) of the ARX volume.

30146
A volume with cifs path-cache enabled has slow performance during busy times.

Version 3.1.0

This section describes the features and fixes from Release 3.1.0. Sites that upgrade from Release 2.7.1 get the benefit of all the features and fixes described here, in addition to the features and fixes described above.

Features

Release 3.1.0 added the following features:

Maximum CIFS Exports Increased from 9,000 to 16,000 (28867)
As of Release 3.1.0, the ARX can support a total of 16,000 CIFS front-end shares.

Add Drive Letter to MSRPCs that Require It (28337)
Some Microsoft Remote Procedure Calls (MSRPCs) require a file or directory path in their returns. Prior to Release 3.2.0, the ARX omitted the drive letter from these returned paths; now a CIFS service includes the drive letter if it has browsing enabled.

Full NSM Core Dumps
You now have the option to enhance the core-dump files produced by a failed NSM processor. By default, a failing NSM processor produces an ASCII-text file with its current state. The new nsm binary-core-files CLI command enhances the files to a much-larger binary format, with more information that F5-Data-Solutions engineers can use for diagnosing the cause of the failure.

Faster Failover Times (28901)
The 3.1.0 release includes enhancements in failover times between redundant ARXes. Lab testing has shown failover times that have improved from 34 - 60%.

Enhancements to CLI "show health," GUI "Status," and E-mail Notifications (27313, 26514)
The SNMP-based indicators of ARX health now offer better support for redundancy features. New indicators notify you of NSM-core failovers, ARX failovers, and quorum-disk failures. These indicators appear in the CLI's show health command, the GUI's "Status" screen (under "System Health Information"), and in E-mail notifications.

The CLI "wait-for migration" Command is Fully Supported
The CLI command, wait-for migration, was formerly accessible only if the terminal beta flag was raised. As of Release 3.1.0, this command is fully qualified, accessible, and documented.

Timeout Option for all CLI "expect" Commands (26737)
Every CLI expect command now has a timeout option, which sets a time limit on the operation. The CLI documentation contains the full syntax.

Reload Option for the CLI "clear nvr" Command (28697)
In previous releases, the clear nvr command halted the chassis at the end of the operation, so that you had to turn the power back on manually. This was designed for preparing the chassis for shipment. In 3.1.0, you have the option to reload the chassis instead of halting it.

Beta Option: Defer Setting "Trust for Delegation" During a Domain Join Operation
If an ARX-CIFS service supports Kerberos authentication, you must perform a domain-join operation to join the service to an Active-Directory domain. The CIFS Service must also have "Trust Computer for Delegation" set at the domain controller. By default, the CLI domain-join command (and its GUI equivalent) requires a username and password with sufficient credentials to set the "Trust Computer for Delegation" flag at the DC. The 3.1.0 release offers a beta option to avoid setting the flag from the ARX:

domain-join domain-name no-trust-for-delegation

You can use lesser credentials to run the command with the no-trust-for-delegation flag raised, then log onto the DC with stronger credentials and raise the flag from there.

This is a beta option that has not been fully qualified. You must use the terminal beta command from the CLI to enable this and other beta features.

Fixes

Release 3.1.0 fixed the software issues below. Fixes for these issues are also included in the current release:

20148
A cryptic error appears in the shadow-copy report when the source volume is undergoing an nsck ... rebuild.

26608
When an import fails for a CIFS share with a corrupt file system, the show namespace command shows an uninformative import error: "...DTFS Operation has error status [-51]."

28100
If you remove a CIFS export at the same instant that the backup ARX reboots, the ARX may incorrectly remove all CIFS exports.

28300
The ASM occasionally hangs during a firmware upgrade operation.

28976
The show exports command may spuriously indicate a successful mount on an NFS share that the ARX cannot import.

28802
The show exports external-filer filer-name command defaults to a spurious IP address, 32.32.32.32, if the ARX definition for filer-name has an undefined IP address. The command should return an error instead of defaulting.

28276
A busy ARX may emit spurious shareOffline traps for shares named "acopia#:...". These shares are internal to the ARX, and should not be reported in SNMP traps.

28180
If a back-end filer uses NFS filehandles that do not align with four bytes (that is, the number of bytes is not evenly-divisible by four), the ARX may reboot repetitively. Only unsupported NFS filers, such as those from Permabit, use NFS filehandles that cause this problem.

29438
A redundant pair of ARX6000s cannot join if the redundancy link has excessive latency; the backup switch repeatedly reboots without ever fully joining its peer.
Solution: For sites with great distances between ARX6000 peers, F5 Support can extend the redundant pair's tolerance for a long latency.

29188
An inconsistencies report (invoked with the nsck ... report inconsistencies CLI command) occasionally misses some replica-leaf directories that it should have recorded as "SD" entries.

28255
A file-placement rule stops scanning directories if a filer returns a serious scan error (such as "path too long") for a single directory.
Solution:: The rule now logs the failed directory in its show policy statistics and continues the scan. The rule retries all such failed directories after the scan is otherwise complete, and marks the rule as "failed" if the scan errors persist.

29396
If a direct volume "attaches" to a managed volume at the same time a client disconnects from the same managed volume, an NSM processor may fail.

27316
In some cases, a CIFS service does not support both NTLM and Kerberos authentication in the same CIFS-client session.

27967
Under rare circumstances, NFS/TCP clients are briefly blocked out of a managed volume if any direct volume in the same VPU Domain is "attached" to it.

28569
The copy reports command (or its GUI equivalent) truncates reports larger than 2GB.

Version 3.0.0

This section describes the features and fixes from Release 3.0.0. Sites that upgrade from Release 2.7.1 get the benefit of all the features and fixes described here, in addition to the features and fixes described above.

NOTE: Upgrades from Release 3.0.0 are not supported. If your system is currently running Release 3.0.0, upgrade to 3.1.0 or 3.2.1 before installing this Release.

Features

Release 3.0.0 provided the following features and enhancements:

Snapshot integration (CIFS only)
Release 3.0.0 provides the ability to manage the generation, removal, and scheduling of periodic snapshots on a per ARX virtual volume basis across heterogeneous filers. Additionally, the ARX can control access and presentation of snapshots.

  • Release 3.0.0 does not support Microsoft VSS or Shadow Copies for Shared Folders.
  • Release 3.0.0 does not support NFS snapshot support beyond what is currently supported with direct (presentation) volumes.

Automatic Volume Sizing (AVS)
With AVS, the number of reserve files is automatically set to 4 million files when an ARX managed volume is created. The reserve file limit is automatically increased by 4 million files every time the number of available file credits falls below 2 million. AVS is automatically disabled if the new required limit exceeds the maximum number of reserve files supported within the managed volume or VPU. For information on the maximum file limits supported per ARX platform, see the Site Planning Guide.

Auto Close File Migration
Prior to 3.0.0, the ARX policy engine would not migrate CIFS files that remained persistently open. The policy engine attempted to migrate an open file for a fixed number of retries. If unsuccessful, the policy rule proceeded to the next file. When complete, the policy engine marked the rule as "FAILED" and generated a report indicating which files where not migrated.

With Release 3.0.0, you can optionally configure a file-placement rule to automatically close any file opened by a CIFS client. The policy engine holds the file closed until it has finished migrating or until the migration request is cancelled.

SNMP Traps and E-Mail Notifications
The smtp welcome command was added to send an introductory (welcome) E-mail to all members in an email-event group. The introductory message informs the recipients of the types of system events they will be receiving through E-mail.

A description field was added to the email-event command.

The warmStart trap has been modified to append the cause of reboot in the message text (traplog and email). All reboots are now recorded in the reboot history log file. The SNMP trap text has not been changed.

Robust SID Translation
Prior to 3.0.0, mis-translation of Security Identifiers (SIDs) could occur if local and domain groups had the same names. With V3.0.0, the SID translation algorithm has changed so that only locally-defined user and group SIDs are subject to translation. This enhancement permits identical user and group names to be defined both locally on a file server and within an Active Directory domain.

CIFS Sub-Share ACL improvements
Prior to V3.0.0, with CIFS sub-shares enabled, an ARX managed volume did not support multiple CIFS shares on the same filer. V3.0.0 removes this limitation, and enables migration, tiering, load balance share farms on a single file server where CIFS sub-shares are configured.

CIFS AD Forest-to-Forest Trusts
In a Windows 2003 Active Directory forest, you can link two disjoint Windows 2003 forests together to form a one-way or two-way trust relationship. A two-way forest trust is used to form a transitive trust relationship between every domain in both forests.

Forest trusts can provide the following benefits:

  • Simplified management of resources across two Windows Server 2003 forests by reducing the number of external trusts necessary to share resources.
  • Complete two-way trust relationships with every domain in each forest.
  • Use of user principal name (UPN) authentication across two forests.
  • Use of Kerberos V5 and NTLM authentication protocols to improve the trustworthiness of authorization data transferred between forests.
  • Flexibility of administration.

V3.0.0 allows for support for CIFS Kerberos authentication across Windows 2003 two-way (or bi-directional) forest-to-forest trusts.

CIFS AD Auto-discovery from the ARX switch
Prior to 3.0.0, Active Directory forest information had to be manually collected from customers and manually configured in the ARX switch.

V3.0.0 enables the ARX switch to perform automatic discovery of all Active Directory information. The auto-discovery feature works within a single AD forest and does not auto-discover forest-to-forest trusts. This feature greatly simplifies and makes less error prone the installation of the switch in CIFS Kerberos environments.

Deterministic directory mastership when using NSCK Rebuild
Prior to V3.0, in some configurations directory mastership was not deterministic after an nsck ... rebuild operation. After the operation dis-assembled all volumes in the namespace and re-imported them, directory mastership was distributed across all shares. In 3.0.0, the ARX software determines directory mastership based on configured place-rules. For example, if age-based tiering is configured, then all master directories will be assigned to tier-1 share(s).

Fixes

Release 3.0.0 also included fixes for the following issues. Fixes for all of these issues are also included in the current release:

19365, 26774
Alarming error messages and logs appear during a firmware upgrade.

26275, 26557
Windows-mgmt-auth information is missing from the show global-config security command.

26278
The show interface command logs OM read errors in syslog.

26493
SSL error with the show ntlm-auth-server command.

27029
Scheduler time is off by 1 hour.

28530
If you perform a domain-join operation from the GUI, the system exposes the password in clear text.

27683
Changing the next-hop gateway for the out-of-band management interface stops all routing through that interface until the next reboot.

24580
The SCM may send redundant nvramECCError traps.

27956
Possible deadlock between NLMD/DNAS with destructive rename.

27314
Import report incorrectly flags collision.

25440
Policy/schedule wrong times.

26043
A shadow-copy rule fails/disables for no reason.

26822
Unable to migrate from one share farm to another.

27192
Cannot enter gbl mode after an upgrade followed by a disk replacement.

27481
SRMount error reported for logon failure.

27657
Redundant switches have a database-transaction leak on backup switch.

27933
The show cifs client-activity command can possibly fail and cause a reboot.

24829
GUI access results in many tiny daily access logs.

27137
Make quorum-disk transitions less aggressive when the peer is offline.

27656
NSM crashed but no core file was collected.

26823
POLICY_SHADOW log message enhancement.

27457
Shadow volume continuously performs full recursive scans when files are open during initial scan.

25154
Some workstations are having problems and not dropping to NTLM after Kerberos fails.

26037
CIFS SHIM messages on DR switch.

26475
After failover, the show health command does not show metaDataOffline status.

26722
Write probes fail but the share is not offline.

26015
GUI column sorting is not always accurate.

26107
Incorrect GUI prompt appears when you remove a Windows management ACL.

27211
Description of GUI sync button incorrect at share level. The Tool Tip displays incorrectly.

26699
Client could not delete a zero-byte file.

26762
Object Manager transaction leak.

27491
The show processor command is not showing valid output.

28093
Share Offline traps displayed for online shares.

26280
Using a SAM-reference file server which has no enabled/active/present user back-end shares on it produces bad results.

27021
Log message if no DVolumeRecords are found.

27910
De-configured switches crash.

26793
Multiple occurrences of NSM cores.

25615
NSM core.

26005
Latency reported from remote site post DST upgrade.

26382
CPU failure.

26585
CIFS clients are unable to access a file or directory with a German umlaut in its name.

26814
NSM-resource-threshold reaching 100% utilization.

27134
avlDbDeleteFromTree crash from cifs_process_reply.

27230
NSM core found on switch. Processor showing as Failed.

27987
NSM cores at primary site.

26376
Enabling browsing defeats Windows-mgmt protection.

27416
Windows restricted accounts denied access.

27739
NSM cores at customer site.

26924
Enhance error message.

26590
Volume stuck in stopping state.

27112
Traps didn't clear.

27378
Need a change in the TRAP subsystem to send email and log a trap when a database corruption is hit and a re-import initiated.

27546
System should allow destage of stopped volumes.

26299
collect logs doesn't collect the switch configuration.

26605
3 cores found on primary switch.

25157
SCM/NVR issues.

26238
Virtual Service not showing in GUI.

26797
Need more accurate messages for NSM cores, etc.

28152
The import is stuck in Starting status.

26744
A rule uses only a single timestamp in its report names if invoked by an age fileset's internal schedule; this causes each report to overwrite its predecessor.

[ Top ]

Required Configuration Changes

This section only applies to installations that upgraded from Release 3.1.0 or earlier.

Once you have installed the software, you must make the following required configuration change(s).

For Sites with Windows Filers, New Filer Setting Required for NTLM Connections
Before Release 3.2.0, the ARX used "non-extended security" for its NTLM-authenticated connections to back-end filers. To correct Issue 27316, the ARX started to use "extended security" for its CIFS connections. However, newer Windows servers require NTLMv2 (not NTLM) for its "extended security" connections. To prepare for an upgrade to Release 3.2.0+ in an installation with Windows filers, verify that the following parameter (from the Windows security-policy UI) allows NTLM connections:

Network security: minimum session security for NTLM SSP based clients.

This policy parameter should be set to "No minimum;" none of the four flags for this parameter should be raised.

The following parameter must also be set so that it does not refuse NTLM from clients (such as the ARX). This was required for ARX Releases before 3.2.0, so you only need to investigate this for new Windows filers or new ARX installations:

Network security: LAN Manager authentication level

You must reboot the Windows server for this (or these) changes to take effect.

Upgrade Firmware and (Optionally) Set NSM Recovery
 

As mentioned above, Release 3.1.0 includes a firmware upgrade. This upgrade is required to support NSM recovery and NSM binary-core files. The required firmware upgrade is discussed above, in Firmware Upgrade for All Chassis Types.

The NSM recovery feature allows an NSM processor to recover after a failure without necessarily rebooting the entire ARX. This configuration change is strongly recommended. After you upgrade the firmware, you can use the nsm recovery CLI command to enable failovers between NSM processors. Refer to the "Preparing for NSM Recovery and Diagnosis" chapter in the CLI Network Guide for full details about the NSM-recovery feature and the nsm recovery command.

Warning: To fully activate the NSM-recovery feature, you must reboot the ARX after you enable it. For a redundant pair of ARXes, enable NSM recovery on the backup ARX first, then enable it on the active ARX (causing a failover to the backup) during off hours.
A stand-alone ARX endures a longer service outage as the ARX reboots; for this reason and others, we recommend redundant ARXes for sites that support extensive client traffic.

[ Top ]

Known Issues

The following items are known issues in the current release.

The ARX4000 Data Plane (NSM side) cannot recover from a power failure until the Control Plane (ASM and SCM side) reboots. (29444)
If the Data Plane (the lower half of the chassis with the network ports) loses power independently of the Control Plane, the Data Plane cannot recover by itself. If both halves of the chassis lose power at the same time (a more-likely event), both halves reboot normally.

Best Practice: The Data Plane and Control Plane each have two power supplies. Connect one power supply from each Plane to one power source, and the other power supply from each Plane to an alternate power source.

Recovery: Stop and restart power on the Data Plane (the upper half of the ARX). This causes both modules to power up in the proper sequence.

The output from collect is inaccessible unless you specify a .tgz extension. (32636)
The collect CLI command (and its GUI equivalent on the Maintenance screen) always creates a zipped tarball. This is traditionally represented by a ".tgz" extension. The ARX expects this extension, and cannot find the output file if you omit the extension or select a different one.

Workaround: Select a ".tgz" extension for all collect output.

UTF-8 Chinese characters are truncated in namespace name. (30941)
If a user enters Chinese characters that exceed the GUI's limit for any input field, the GUI will not issue an error message but instead simply truncates the input.

The GUI input fields limit input based on characters and not bytes. When entering multi-byte characters, the input may be truncated if the total number of bytes representing the characters exceed the internal byte limit.

ARX CLI fails if you enter multi-byte characters (such as Japanese characters) through a terminal emulator that does not support UTF-8. (31073)
The ARX character set and the terminal character set must match or the CLI may crash. You can set the ARX to accept UTF-8 characters with the terminal character-set unicode-utf-8 CLI command. The crash occurs when the terminal software is not set for UTF-8 and sends multi-byte characters to a CLI that is configured for UTF-8.

Workaround: To enter multi-byte characters, use a terminal emulator/TELNET program that supports UTF-8.

The CLI "show clock" output does not always show the correct time after a time-zone change. (24526)
You can use the clock timezone CLI command to set the time zone of the ARX. On rare occasions, the output from the show clock command does not show the correct time after this change. For example:

ARXa500# clock set 14:43:00 01/11/2007
ARXa500# show clock
        Local time:  Thu Jan 11 14:43:02 2007 EST -0500 America New_York
    Universal time:  Thu Jan 11 19:43:02 2007 UTC
ARXa500# config
ARXa500(cfg)# clock timezone America Denver
ARXa500(cfg)# show clock

        Local time:  Thu Jan 11 14:43:13 2007 EST -0500 America Denver
    Universal time:  Thu Jan 11 19:43:13 2007 UTC

The time does not conform to the new time zone, though the correct new time zone (America Denver) does appear in the output.

Workaround: Log out of the CLI and log back in.

During the hour of transition from daylight-savings time to standard time, the clock set CLI command incorrectly interprets times in some time zones. (24709)
Times are ambiguous in the hour when daylight-savings time reverts to standard time, once per year. Suppose the transition occurs at 3 AM on the day of the daylight-savings change: time passes from 3 to 4 AM in daylight-savings time, then the clock goes back to 3 AM for standard time, and then time passes from 3 to 4 AM again. In some time zones, if you reset the clock to a time between 3 and 4 AM, the clock set command may not interpret your time correctly. If this occurs, the ARX assumes that the transition to standard time has already occurred.

This only occurs in time zones that are East of the Prime Meridian, with positive offsets from UTC.

Workaround: Avoid the clock set command during the day and hour of transition.

An ARX4000 does not support jumbo frames with 4.1.0+ software and older firmware. (32103)
On an ARX4000 that is running 4.1.0 or later software with an earlier version of firmware, NSM cores fail if they are configured for jumbo frames. (You can enable or disable jumbo frames with the [no] jumbo mtu CLI command.)

Workaround: A workaround is only necessary if you upgrade an ARX4000 from Release 4.0.0 or earlier. In this case, upgrade the ARX4000 with the latest firmware as part of the installation process. For installation instructions, including the method for upgrading firmware, refer to the Upgrading Software chapter in the CLI Maintenance Guide.

The ARX cannot send E-mail messages through the out-of-band (OOB) management interface. NTP, DNS, RADIUS, and snapshot-management services (SSH and RSH) are also unsupported through the OOB interface. (24595)
All e-mail notifications from the ARX go out through an in-band (VLAN) management interface, configured with the interface vlan CLI command. At least one in-band-management interface must have a route to the E-mail server for E-mail notifications to function. The same applies to NTP, DNS, and RADIUS services, as well as SSH and RSH for managing filer snapshots.

Workaround: Use the cfg-mode ip route command (without the mgmt flag) to add a static IP route to the E-mail server(s), NTP server(s), DNS server(s), and/or RADIUS servers. All filers and file servers must have a route to be useable by the ARX at all, so this is less likely to be an issue for SSH and RSH.

The management address for an external filer cannot be on the out-of-band (OOB) management subnet for the ARX. (25487)
To support coordinated snapshots in an ARX volume, the volume requires the management-IP address for the filer. You set this with the ip address a.b.c.d management CLI command, or its GUI equivalent. This address cannot be on the same subnet as the ARX's OOB interface. This is related to issue 24595, above.

The ntp server command allows v1 and v2 of the NTP protocol. (30634)
v1 and v2 are not supported. Refer to the CLI Reference Guide for details.

Spurious errors appear in the syslog after an NSM failover. (25782)
NSM processors have redundant peers, even in an ARX that is not configured for overall redundancy. If an NSM processor fails, its peer processes packets for both. If nsm recovery is enabled, the failed processor comes back online and waits to take over for the running processor. The failed processor may repeatedly put the following message in the syslog:

 NAT rule TCP/ip-address:port for remote action ip-address-2:port-2 type 3 not found.

This syslog message is spurious.

Under very rare circumstances, the ARX may block administrative logins after a reboot. (32537)
An ARX in the F5-Development laboratory did not allow administrative logins after a reboot. Logins to the serial-Console port always timed out after entering the administrative password, and logins to the Out-of-Band Management port (typically labelled "MGMT") were rejected with this error message:

ssh_exchange_identification: Connection closed by remote host

F5 Development has been unable to reproduce this problem, despite hundreds of reboots. We note it here until the problem is proven to be unreproducible at any customer site.

Recovery: Power cycle the ARX.

The show ntlm-auth-server status CLI command gets an OPEN_SSL_ERROR string if the NTLM-server password is too long. (31029)
The ARX Secure Agent (ASA) applet and the ARX CLI allow an ASA password of up to 64 characters, but underlying encryption software supports a maximum of 22 characters.

Workaround: If you see this error, change the password so that it is 22 characters or less. This change must occur in two places: at the NTLM-Authentication Server (where the ASA is installed) and at the ARX CLI. For instructions on modifying the ASA password, both on the ASA and in the ARX CLI, refer to the Secure Agent Installation manual.

You must separately export a CIFS managed volume if you use it as a "managed volume" in a CIFS presentation volume. (21231, 24359)
If a CIFS-managed volume is used as a managed volume in a CIFS-presentation volume, its CIFS front-end service must export the managed volume separately. This is in addition to the export for the presentation (or direct) volume. (The same CIFS service must export both volumes.)

A client IP address remains in the output of show nfs-service mounts after the client unmounts. (24478)
The output of the show nfs-service mounts command is a table of NFS mounts from client machines. For each currently-active client mount, the table displays the Global Server, the mount point, the VIP, and the client IP address.

When the client is unmounted, there may be a slight lag in the update of table information, and a repeat of the show nfs-service mounts command may show the client still mounted.

Workaround: Retry the show nfs-service mounts command.

A ill-timed filer error can result in a spurious "Completed" state for a file-placement rule. (32570)
A filer error or connection error can cause failed migrations for a file-placement rule. If this error occurs at the wrong instant, the migration status for the rule run erroneously appears as "Complete." This incorrect status appears in the output of the show policy namespace vol-path rule-name CLI command, or its GUI equivalent. The Total Failed Migrations field in the same output correctly shows the number of failed migrations.

Recovery: Correct the filer error and manually rerun the file-placement rule. This timing issue is rare, and unlikely to occur on a second run.

A non-specific error appears in some failed file-placement-rule reports. (32609)
The report for a failed file-placement rule may terminate with the RULE_INTERRUPTED error. This error is designed for rules that were interrupted by configuration changes and reboots. It is also inappropriately used for filer errors and connection issues.

The Volume Scan Status field may display a "Volume Paused" state after the policy engine has resumed. (32619)
After a volume's policy engine pauses and resumes, it may display an incorrect scan status. This incorrect status indicates that the scan is still paused. It appears in the output of the show policy namespace vol-path rule-name CLI command, or its GUI equivalent. This is a display issue only; the file-placement rule correctly resumes its scan when policy resumes.

The 'Files in Fileset' counter is incorrect in a File-Placement report and the 'show policy' (detailed) output. (32468)
The counter for "Files in Fileset" is higher than the actual number of files when it is incorrect.

Rule never fails when target is out of space. (32080)
Sometimes files need to be move to a share; however, there is not enough space on a target share. The rule still tries and migrations continue to fail. Instead of the rule stopping, it just keeps on trying. This delays other volume scans for other volumes on the same VPU domain.

Workaround: Disable the rule that is scanning.

If you incorporate a non-existent filer snapshot into an ARX-snapshot rule, the ARX erroneously creates an empty ARX snapshot. (32728)
An administrator can use the snapshot manage CLI command (or its GUI equivalent) to incorporate a back-end snapshot into a ARX-snapshot rule. If the administrator specifies a back-end snapshot that does not exist, the ARX erroneously adds an empty snapshot to the rule.

Recovery: Remove the spurious snapshot and then re-run the snapshot manage operation with the correct back-end-snapshot name. You can remove the ARX snapshot with the snapshot remove namespace vol-path rule snapshot CLI command (where snapshot is the spurious ARX snapshot) or its GUI equivalent.

Spurious syslog errors after snapshot commands. (32230)
After a snapshot command like show snapshot or its GUI equivalent, the following spurious error may appear in the syslog file (available through the GUI or the show logs syslog CLI command):

OM_RECORD_READ_FAILED:: A record read from the configuration database failed. 
Record result code [noMoreRecords [4]] Record name [StorageContainer] 
Debug string [containerName="", filerId=0].

The "noMoreRecords" error (shown above) and the "keyNotFound" error (not shown) are sometimes spurious.

Incorrect "Snapshot State" in snapshot reports and the output of the "show snapshot" CLI command. (32473)
The "Snapshot State" of a sparse snapshot should appear as "Sparse" if any of the volume's shares are excluded for any reason. The snapshot state appears as "Complete" when shares are excluded because of filer configuration. The snapshot state is correct when shares are explicitly excluded with the CLI exclude command or its GUI equivalent.

Workaround: Observe the "Excluded Shares" section of the report (or command output). This is correct. If any shares appear in this section, the snapshot is sparse.

Shadow Volume sync performance for ARX4000 is poor compared to ARX6000. (30406)
This issue is being actively worked. The issue is alleviated when pursuing the following Best Practice:

  • Set "receiver-threads" to 1 on your shadow rule before initial treewalk ONLY with a pre-seeded target on CIFS.
  • Set "receiver-threads" back after the treewalk is complete.

This will give a speedup of up-to 4x during initial treewalk vs. default settings, but ONLY with a pre-seeded target on a CIFS volume.

NSCK reports do not identify "marked" multi-protocol directories where you should run a sync files operation. (23891)
Some multi-protocol (NFS and CIFS) directories are "marked" for special processing. These directories contain files and/or subdirectories one of these naming issues:

  • the name resembles a Filer-Generated Name (FGN, such as "myfile~1.txt"), or
  • the name produces an FGN on its back-end filers (such as "my:file.txt," or "MYFILE" in the same directory as "myfile").

If a directory is marked with one of these naming issues, the volume performs extra processing whenever a client tries to introduce an entry with the other naming issue. Depending on the outcome of the processing, the new client entry could become NFS-only (inaccessible to CIFS clients). Refer to the CLI Maintenance Guide for details.

Clients can resolve these issues by accessing the volume through its VIP and renaming the directory's entries. However, the directory mark persists after all of its child entries have been correctly renamed; you use the sync files CLI command to remove the mark.

The issue is that there are no reports that identify a directory as "marked" after its entries have been correctly renamed.

Workaround: Use sync files to clear the directory mark immediately after renaming its entries.

Under rare circumstances, an nsck ... rebuild on a shadow volume can make the volume stall in "importing" state. (18135)
If a shadow volume meets all of the following criteria when someone issues an nsck ... rebuild command, the shadow volume stays in "importing" state for a long time (perhaps hours), and is inaccessible to clients:

  • The shadow-copy-rule has its publish command set to group (the default),
  • The source volume contains millions of files,
  • The shadow-copy rule was near the end of a run, so most of the files were copied into the shadow volume's staging area (the hidden .acopia_shadow directory in the root of each share).

The root of the problem is that the .acopia_shadow directories contain millions of files, and the nsck ... rebuild must remove those directories at the beginning of its process. Clients cannot access the volume until all the filers are able to delete this directory.

If this occurs, messages appear in the syslog that describe the problem.

[ Top ]

Contacting F5 Networks

  F5 Online Knowledge Base: https://support.f5.com/
F5 Services Support Online: https://www.f5.com/training-support/customer-support/

 

F5 Online-Request Form: https://login.f5.com/resource/login.jsp
Email: support@f5.com
Telephone: https://www.f5.com/training-support/customer-support/contact/

 

For additional information, please visit http://www.f5.com.

[ Top ]

Was this resource helpful in solving your issue?




NOTE: Please do not provide personal information.



Incorrect answer. Please try again: Please enter the words to the right: Please enter the numbers you hear:

Additional Comments (optional)