Readme and Release notes for release 4.2.3.2 IBM Spectrum Scale 4.2.3.2 Spectrum_Scale_Standard-4.2.3.2-ppc64-AIX-update Readme
Readme file for:Spectrum Scale
Product/Component Release:4.2.3.2
Update Name:Spectrum_Scale_Standard-4.2.3.2-ppc64-AIX-update
Fix ID:Spectrum_Scale_Standard-4.2.3.2-ppc64-AIX-update
Publication Date:21 June 2017
Last modified date:21 June 2017
Online version of the readme file:http://www-01.ibm.com/support/docview.wss?rs=0&uid=isg400003391
Important: The most current version of the readme file can always be found online.
Contents
Download location
Prerequisites and co-requisites
Known issues
Installation information
Additional information
Copyright and trademark information
Download location
Below is a list of components, platforms, and file names that apply to this Readme file.
Fix Download for AIX
Fix Download for AIX
Prerequisites and co-requisites
-
Prerequisites
You must have a licensed version of IBM Spectrum Scale 4.2.3.0.
Known issues
-
Problems discovered in IBM Spectrum Scale releases
Installation information
After you have downloaded IBM Spectrum Scale for AIX update package into any directory on your system, use the following section to install the fix package.
-
Installing IBM Spectrum Scale for AIX
- Choose the download option "Download using Download Director" to download the new Spectrum Scale package and place it in any location desired on the install node. Note, if you must (not recommended) use download option "Download using your browser (HTTPS)", instead of clicking on the down arrow to the left of the package name, you must right-click on the package name and select the Save Link As.. option. If you just click on the download arrow, the browser will likely hang.
- Follow the installation and migration instructions in your IBM Spectrum Scale Installing and upgrading.
Complete these steps to install the fix package:
- Unzip and extract the BFF image(s) from the file that was just downloaded:
< r/>
gzip -d -c < filename > | tar -xvf -
- Verify the update image(s) in the directory.
Normally, the images in the directory would be similar to the following:
- UXXXXXX.gpfs.base.bff
- UXXXXXX.gpfs.docs.data.bff
- UXXXXXX.gpfs.ext.bff
- UXXXXXX.gpfs.gskit.bff
- UXXXXXX.gpfs.msg.en_US.bff
- UXXXXXX.gpfs.adv.bff (IBM Spectrum Scale Advanced Edition or IBM Spectrum Scale Data Management Edition only)
- UXXXXXX.gpfs.crypto.bff (IBM Spectrum Scale Advanced Edition or IBM Spectrum Scale Data Management Edition only)
- UXXXXXX.gpfs.license.std.bff (IBM Spectrum Scale Standard Edition)
- UXXXXXX.gpfs.license.adv.bff (IBM Spectrum Scale Advanced Edition)
- UXXXXXX.gpfs.license.dm.bff (IBM Spectrum Scale Data Management Edition)
where XXXXXX represents the six (6) digits of the PTF number for the BFF image.
For specific filenames, check "Package information" in this Readme for the IBM Spectrum Scale update.
- Follow the installation and migration instructions in your IBM Spectrum Scale Installing and upgrading.
-
Upgrading GPFS nodes
Upgrading GPFS may be accomplished by either upgrading one node in
the cluster at a time or by upgrading all nodes in the cluster at
once. When upgrading GPFS one node at a time, the below steps are
performed on each node in the cluster in a sequential manner. When
upgrading the entire cluster at once, GPFS must be shutdown on all
nodes in the cluster prior to upgrading.
When upgrading nodes one at a time, you may need to plan the order
of nodes to upgrade. Verify that stopping each particular machine
does not cause quorum to be lost or that an NSD server might be the
last server for some disks. Upgrade the quorum and manager nodes
first. When upgrading the quorum nodes, upgrade the cluster manager
last to avoid unnecessary cluster failover and election of new
cluster managers.
-
Prior to upgrading GPFS on a node, all applications that depend
on GPFS (e.g. DB2) must be stopped. Any GPFS file systems that
are NFS exported must be unexported prior to unmounting GPFS
file systems.
-
Stop GPFS on the node. Verify that the GPFS daemon has
terminated and that the kernel extensions have been unloaded
(mmfsenv -u). If the command mmfsenv -u reports that it cannot
unload the kernel extensions because they are "busy", then the
install can proceed, but the node must be rebooted after the
install. By "busy" this means that some process has a "current
directory" in some GPFS filesystem directory or has an open file
descriptor. The freeware program lsof can identify the process
and the process can then be killed. Retry mmfsenv -u and if that
succeeds then a reboot of the node can be avoided.
-
Use the 'inutoc .' command to create a .toc file which will be used by the installp command. The .toc file will be created in the current working directory.
-
Once the .toc file is created, Upgrade GPFS using the installp command or via SMIT on the
node. If you are in the same directory as the install packages and the .toc file,
an example command might be:
installp -agXYd . gpfs
Additional information
-
Notices
-
Package information
The update images listed below and contained in the tar image are maintenance packages for IBM Spectrum Scale. The update images can be directly applied to your system.
The update images require a prior level of IBM Spectrum Scale. Thus, the usefulness of this update is limited to installations that already have the IBM Spectrum Scale product. Contact your IBM representative if you desire to purchase a fully installable product that does not require a prior level of IBM Spectrum Scale.
After all BFFs are installed, you have successfully updated your IBM Spectrum Scale product.
- Follow the installation and migration instructions in your IBM Spectrum Scale Installing and upgrading.
Update to Version:
Update from Version:
4.2.3.0 - 4.2.3.1
Update (tar file) contents:
- U877084.gpfs.docs.data.bff
- U877085.gpfs.ext.bff
- U877086.gpfs.base.bff
- U877087.gpfs.msg.en_US.bff
- U877088.gpfs.adv.bff (IBM Spectrum Scale Advanced Edition or IBM Spectrum Scale Data Management Edition only)
- U877089.gpfs.crypto.bff (IBM Spectrum Scale Advanced Edition or IBM Spectrum Scale Data Management Edition only)
-
Summary of changes for IBM Spectrum Scale
Unless specifically noted otherwise, this history of problems fixed for IBM Spectrum Scale 4.2.x applies
for all supported platforms.
Problems fixed in IBM Spectrum Scale 4.2.3.2 [June 21, 2017]
- Address a problem where AFM recovery stalls on a read of an IW fileset when it
waits to fetch the file from home after the recovery completes.
- Improve a conditional ccr update for CES IPs list file.
- Fix a problem that causes RenameHandler long waiter. This can occur if PIT is
in progress.
- Fix a Ganesha crash that can occur when the user enters a string which
contains a colon in any mmnfs command that requires a client option or client
list string.
- Fix an assert that can occur when changing gateway nodes to non gateway nodes
while operations are being performed on an iw fileset and then the non gateway
nodes are turned back into gateway nodes.
- Fix a rare deadlock that can occur between a thread handling mmap and a thread
handling a memory map pagefault.
- Fix an E_STALE failure that can occur when during a DMAPI dm_read_invis.
- Fix long waiters that can occur on a very busy system doing background
snapshot deletion.
- Fix a case where GPFS skipped shrinking lastdata block which causes excess
space to be consumed.
- Improve the mmsetquota error message that occurs when a block limit is
specified in 'T' unit and larger than 909T is specified.
- Fix an assert that can occur when mmcheckquota and mmrepquota are passed
fileset ids from deleted filesets.
- Fix an issue in the AFM environment where afmHardMemThreshold configuration
value is not honored and more memory is used than specified.
- Increase the wait time for commands to execute, before failing.
- Correct formatting of large call counts reported by "mmfsadm vfsstats".
- Fix long waiters that can occur after a file system panic and a very busy
system.
- Fix a problem in which inodes become Busy after unmount with NFS and immutable
files.
- mmkeyserv: Make it possible to set certain attributes to the default with the
use of "delete" or "default" keyword.
- Fix a problem in which mkdir, creates, and resync can fail during revalidation
from cache/primary to home/secondary in newer kernels 3.18 or later.
- Fix a problem in which GPFS can not handle errors that occur when a DM
application was unable to retrieve data due to offline tape.
- Suppress repeated message "Expanded ... inode space N from X to Y inodes" in
mmfs.log.
- Fix a rare quota management deadlock caused by error conditions such as out of
disk space.
- Fix an issue in AFM+HSM environment where resync/failover/changeSecondary
commands fails to replicate migrated files.
- Fix an issue in the AFM environment where a fileset force unlink could cause
the daemon to crash.
- Address a problem where a gateway node can assert/crash when having more than
1024 active fileset operations occurring across different filesets on a single
gateway node.
- Fix a problem in which gpfs.snap may not gather mmfs logs on AIX nodes
correctly.
- Fix a clone parent file deletion performance issue.
- Fix a problem in which fsetxattr failed with ENOENT using a fd of an unlinked
file.
- Fix the Assert exp(fileLockHeld != LkObj::nl) in fetchBufferM() that can occur
when compression is being used.
- Fix a problem where DMAPI invis read/write fails with an err 22 when calling
from non session node.
- Fix a problem in which the mmnetverify command does not correctly verify
remote addresses when running many tests in parallel.
- Fix a deadlock that is very rare and can occur after running snapshot
commands.
- Fix a policy problem which causes the LOWDISKSPACE callback to not trigger
after a fs manager takeover when the old fs manager fails because of an abort
or a lost connection.
- This update addresses the following APARs: IV96355 IV96416 IV96417 IV96418
IV96419 IV96420 IV96425 IV96426 IV96429 IV96472 IV96473 IV96474 IV96476
IV96482 IV96483 IV96487 IV96488 IV96585 IV96761 IV96762 IV96763 IV96764
IV96783 IV96786 IV96791.
Problems fixed in GPFS 4.2.3.1 [May 16, 2017]
- Fix a Ganesha crash caused by an applyUpdate.
- Fix a ccrio initialization failure (err 811) when changing the
daemon-interface.
- Fix a rare segmentation fault in the mmgetstatus command.
- Fix a SIGBUS error that can occur during a mmap read on a snapshot file.
- Fix a problem in which we see a flood of "failed to scrub vdisk" log message
when GNR node experiences quorum loss. This is for ESS/GSS.
- Fix a rare race between unlink, lookup and token revoke which causes kernel
crash in d_revalidate.
- This fix will make sure Ganesha request reference a valid GPFS filesystem.
- Fix a system hang that can occur when a file system is suspended while doing a
mmap.
- This fix rejects unreasonable large requests to preallocate inodes immediately
with ENOSPC.
- Fix a directory rename issue with IW filesets that can occur if the rename
target is an existing directory.
- Fix a fault that can occur when restripe runs while the SG is not mounted on
all NSD nodes.
- This fix restricts the afmMaxParallelRecoveries config value from 0 to 128.
- This fix removes the unnecessary error message "cannot open /proc/net/tcp6"
when shutting down GPFS.
- Fix a problem with not properly handling quotas in an AFM environment. This
can occur when you have very large hard and soft limit values.
- Fix a "exp(!sgP->isSGMgr())" assert that can occur when you delete a file
system and then create a new file system with the same name at the same time.
- Fix an err 112 that can show up in the mmfs logs when mmchnode --gateway is
executed.
- Fix a kernel crash that can occur while attempting to mount a loop device to a
correspond file in a GPFS file system or while using a GPFS file system file
as a LIO backend.
- Address a problem where applyUpdates continues to run even if the fileset at
the old primary is unlinked or the mmfs daemon has been shutdown.
- Fix an outband resync failure that can occur if a recovery is triggered by
deleting some files in a directory and the directory itself. This is an AFM/DR
environment.
- Fix rename conflicts that can occur in SW/DR filesets.
- Update log code to prevent log recovery error when log file became
illReplicated. This could happen on file system with -K set to NO and there is
not enough disk space for full replication.
- This fix will use new interface that will reduce multiple retries every time a
lock is freed and there are multiple waiters for the lock.
- Fix an assert that can occur with a DR fileset and the file system is
suspended.
- Fix bug that requires a large free space in /var/mmfs to run change commands.
- Fix recovery failure err 17 when psnap0 deletion fails.
- Fix a daemon assert that can occur in an AFM environment where the mmfsd
daemon fails to start repeatedly with a DMAPI enabled filesystem at a gateway
node.
- Address a problem where trying to queue a writeSplit message to the helper
gateway's queue can fail with an error 28 (E_NOSPAC).
- Fix an issue which returns EACCESS(errno = 13) while running mmapplypolicy
when there is a mounted NFS file system which has the same name with a GPFS
file system.
- A fastpath optimization defect can result in an internal error to be returned
to the user when it is safe to continue without entering the fast path.
- Install if you suffer from mmapplypolicy/tspolicy hanging after otherwise
finishing all work.
- cNFS: fix a problem with /usr/sbin/rpcinfo not found in SLES12 or later.
- Fix a failure in Object Authentication configuration with Active Directory or
LDAP. This fix is only required if Object is being configured with Active
Directory or LDAP and DN of Swift service user(specified in --ks-swift-user)
is more than 79 characters.
- Fix a problem with ESS disk replacement in which the mmchcarrier command may
wipe out the pdisk location code. The problem will prevent the subsequent
mmchcarrier command to proceed without a valid location code.
- Fix a problem in which a GPFS command may wrongly terminate another process.
- Fix a rare deadlock problem caused by stream write(enableRepWriteStream=yes).
- Update log recovery code to avoid GPFS daemon assert after detecting invalid
directory block during log recovery. Code has been changed to log a FSSTRUCT
error and fail the log recovery so offline mmfsck can be run on the file
system.
- Fix a mmfsd crashes (incompleteOk assertion), when the number of files in the
committed directory doesn't match the number of files in CCR's file list in
case of a new CCR file update request.
- This update addresses the following APARs: IV94991 IV94992 IV94994 IV94995
IV94996 IV94997 IV94998 IV95015 IV95021 IV95230 IV95557 IV95643 IV95925
IV96037 IV96163.
Copyright and trademark information
http://www.ibm.com/legal/copytrade.shtml
Notices
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
PURPOSE. Some jurisdictions do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this
statement may not apply to you.
This information could include technical inaccuracies or
typographical errors. Changes are periodically made to the
information herein; these changes will be incorporated in new
editions of the publication. IBM may make improvements and/or
changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Microsoft, Windows, and Windows Server are trademarks of Microsoft
Corporation in the United States, other countries, or both.
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino,
Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and
Pentium are trademarks or registered trademarks of Intel Corporation or its
subsidiaries in the United States and other countries.
Other company, product, or service names may be trademarks or
service marks of others.
THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION
The license agreement for this product refers you to this file for
details concerning terms and conditions applicable to third party
software code included in this product, and for certain notices
and other information IBM must provide to you under its license
to certain software code. The relevant terms and conditions,
notices and other information are provided or referenced below.
Please note that any non-English version of the licenses below is
unofficial and is provided to you for your convenience only. The
English version of the licenses below, provided as part of the
English version of this file, is the official version.
Notwithstanding the terms and conditions of any other agreement
you may have with IBM or any of its related or affiliated entities
(collectively "IBM"), the third party software code identified
below are "Excluded Components" and are subject to the following
terms and conditions:
- the Excluded Components are provided on an "AS IS" basis
- IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND
CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING,
BUT NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR
INTERFERENCE AND THE IMPLIED WARRANTIES AND CONDITIONS OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
- IBM will not be liable to you or indemnify you for any claims
related to the Excluded Components
- IBM will not be liable for any direct, indirect, incidental,
special, exemplary, punitive or consequential damages with
respect to the Excluded Components.