Documente Academic
Documente Profesional
Documente Cultură
4 Release Notes
Table of Contents
Introduction ______________________________________________________________________________ 3
New Features and Improvements ____________________________________________________________ 4
Hot Fixes Included in this Release __________________________________________________________ 4
Resolved Issues __________________________________________________________________________ 6
Compatibility and Packaging ________________________________________________________________ 8
Linux Compatibility ______________________________________________________________________ 8
System Software Release Packaging ________________________________________________________ 9
Software Installation Instructions ____________________________________________________________ 10
Verify Kernel Version ____________________________________________________________________ 10
Verify Linux FSD Version ________________________________________________________________ 10
Installing for the First Time _______________________________________________________________ 10
Installation Issues ______________________________________________________________________ 11
Upgrading From a Prior Release ___________________________________________________________ 11
Mounting a Harmonic MediaGrid File System _________________________________________________ 12
Operational Notes ________________________________________________________________________ 13
Specifying File Buffering _________________________________________________________________ 13
Specifying Number of Write Threads ________________________________________________________ 13
Memory Usage by the Linux FSD __________________________________________________________ 14
Setting the Cache Memory Limit ___________________________________________________________ 15
Multiple NIC Support ____________________________________________________________________ 15
Linux File Permissions ___________________________________________________________________ 16
Internet Protocol Ports Used ______________________________________________________________ 16
Warnings, Exceptions, and Issues ___________________________________________________________ 17
Page 2 of 18
Introduction
Welcome to the release notes for Harmonic MediaGrid Linux FSD (File System Driver) Version 3.4. This
document covers important information about the Harmonic MediaGrid Linux FSD software, including installation
instructions, known issues, and workarounds.
In addition, given the sophisticated functionality of distributed storage systems, this document also refreshes
some general information that may pertain to your specific installation. Please read these release notes
thoroughly prior to upgrading any software, as all sections contain important information.
Note the following versioning/naming scheme for releasing updates to Harmonic MediaGrid and File
System Driver (FSD) releases: MajorNumber.MinorNumber.ServiceRelease.CummulativePatchNo.(For
example, 3.4.0.0.) References to the version numbers specified in this document are based on this
versioning scheme.
This document includes the following:
New Features and Improvements in Linux FSD 3.4
Resolved Issues in Linux FSD 3.4
Compatibility and Packaging for Linux FSD 3.4
Installation Instructions for Linux FSD 3.4
Operational Notes for Linux FSD 3.4
Warnings, Exceptions, and Issues for Linux FSD 3.4
Page 3 of 18
Description
This release includes support for the following additional Distros / Kernels:
Kernels
MG-9938: Debian 6.0.5 (2.6.35.10.x86_64)
MG-10015: CentOS 6.5 patch 1.2.0.1 (2.6.32-431.1.2.0.1.el6.x86_64)
MG-10016: CentOS 6.5 patch 20.3 (2.6.32-431.20.3.el6.x86_64)
MG-10077: CentOS 6.5 patch 23.3 (2.6.32-431.23.3.el6.x86_64)
MG-10041: CentOS 6.5 plus patch 17.1
(2.6.32-431.17.1.el6.centos.plus.x86_64)
MG-10130: CentOS 6.2 patch 13 (2.6.32-220.13.1.el6.x86_64)
MG-10053: SuSE 10.2 patch 0.27 (2.6.16.60-0.27-smp.x86_64)
MG-10107: CentOS/Autodesk 6.2 patch 27
(2.6.32-220.27.1.el6.x86_64)
MG-10356/MG-10524: CentOS 6.5 (Kernel level
2.6.32-431.el6.x86_64)
MG-10460: Ubuntu 14.04.24 (Kernel level 3.13.0-24-generic Ubuntu)
MG-10461: CentOS 6.6.3.3 (Kernel level 2.6.32-504.3.3.el6.x86_64)
MG-10467: CentOS 7.0.9.3 (Kernel level 3.10.0-123.9.3.el7.x86_64)
MG-10477: CentOS 6.6 (Kernel level 2.6.32-504.el6.x86_64)
MG-10518: Debian 6.0.4 (Kernel level 2.6.32-5-amd64)
MG-10531: Debian 7.8 (Kernel level 3.2.0-4-amd64)
MG-10532: CentOS 6.5.29.2 (Kernel level 2.6.32-431.29.2.el6.x86_64)
Description
Page 4 of 18
Feature
Description
Support for Ubuntu This release includes support for Ubuntu and Kernel versions that are greater than 2.6.
and Kernel
versions that are
greater than 2.6
Ubuntu installation includes a module named omfs.ko, which happens to create a name
conflict with the Harmonic MediaGrid Linux FSD. In order to install the Linux FSD on an
Ubuntu machine, you will need to use the --force-overwrite option to overwrite the
existing omfs.ko module.
In order to install the Linux FSD on an Ubuntu machine, run the command as follows.
1. Type the following:
sudo dpkg -i --force-overwrite
mediagridfsd_3.2.1.2-20140512-3.2.0-29-generic_amd64.deb
2. Restart the Linux FSD client.
Note that the default log location of an Ubuntu machine is /var/log/syslog instead of
/var/log/messages.
This release includes support for the following additional Distros / Kernels:
Distros / Kernels
MG-9771: CentOS 6.3 patch 22 (2.6.32-279.22.1.el6.x86_64)
MG-9708/MG-9751: CentOS 6.4 patch 2 (2.6.32-358.2.1.el6.x86_64)
MG-9789: CentOS 6.5 patch 5 (2.6.32-431.5.1.el6.x86_64)
MG-9777: CentOS 6.5 patch 11.2 (2.6.32-431.11.2.el6.x86_64)
MG-9505: Ubuntu 12.04 (3.2.0-29-generic_amd64)
Description
This release includes support for the following additional Distros / Kernels:
Kernels
MG-9591: CentOS 6.2 for x86_64 (Kernel level
2.6.32-220.2.1.el6.x86_64)
MG-9629: SLES 11SP1 for x86_64 (Kernel level 2.6.32.12-0.7-default)
MG-9630/MG-9305: SLES 11v2 for x86_64 (Kernel level
3.0.13-0.27-default)
MG-9581: SLES 11v3 for x86_64 (Kernel level 3.0.76-0.11-default)
Page 5 of 18
Resolved Issues
The following has been resolved in this release.
Key
rn summary
MG-10469 The Linux FSD may cause a kernel crash in cases where many threads or processes are
simultaneously reading the same file and where a read timeout occurs due to network, server,
and/or client congestion. This was fixed by reworking the cleanup actions after a read timeout.
MG-10433 The Linux FSD incorrectly logs very long IO times (hundreds of seconds). This was due to code
paths which failed to correctly set the start time which have been fixed.
MG-10360 The Linux FSD may crash the kernel in addSliceEntry() due to a previous zero-length allocation.
A check was added to avoid the zero-length allocation.
MG-10339 In some cases, when accessing files on the Harmonic MediaGrid, if the files were rapidly written,
closed, truncated, then opened and written again with less data, the files were not truncated
correctly.
MG-10228 The Linux FSD sometimes crashed the kernel in 3.X kernel versions. This was due to a logic
problem in filling in kernel "inode" structures which has been corrected.
MG-10047 The Linux FSD causes a kernel crash after mount or during operation due to a memory
corruption problem. This was fixed by increasing the size of a string buffer by one byte.
MG-9797
In some cases, when copying files via CIFS, the Linux FSD client could restart suddenly.
7 issues
This release also includes the resolved issues provided in the following hot fixes:
Linux FSD 3.2.1.2
Key
rn summary
MG-9756 Error in coding caused operations on non-existent files to fail with EEXIST, resulting in failure of
cp(1) and mv(1) commands.
MG-9675 Fixed lseek(2) failure observed on kernels having a version greater than 2.6.36.
2 issues
Linux FSD 3.2.1.1
Page 6 of 18
Key
rn summary
MG-9469 Provided limited support for non-root file owners of an NFS share.
MG-9007 Provided limited support for PHP copy.
2 issues
Page 7 of 18
Linux Compatibility
Harmonic MediaGrid Linux FSD Release 3.4 is compatible with the following Linux distributions:
RedHat Fedora 4 for x86_64 (Kernel level 2.6.17-1.2142_FC4smp)
RedHat Fedora 13 for x86_64 (Kernel level 2.6.34.9-69.fc13.x86_64.x86_64)
RedHat Enterprise Linux 5.3 for x86_64 (Kernel level 2.6.18-128.el5.x86_64)
RedHat Enterprise Linux 5.4 for x86_64 (Kernel level 2.6.18-164.el5.x86_64)
RedHat Enterprise Linux 5.7 for x86_64 (Kernel level 2.6.18-274.el5.x86_64)
RedHat Enterprise Linux 6.0 for x86_64 (Kernel level 2.6.32-71.el6.x86_64)
RedHat Enterprise Linux 6.2 for x86_64 (Kernel level 2.6.32-220.el6.x86_64)
RedHat Enterprise Linux 6.4 for x86_64 (Kernel level 2.6.32-358.el6.x86_64)
SLES 11SP1 for x86_64 (Kernel level 2.6.32.12-0.7-default)
SLES 11v2 for x86_64 (Kernel level 3.0.13-0.27-default)
SLES 11v3 for x86_64 (Kernel level 3.0.76-0.11-default)
SUSE Linux 10.2 patch 0.27 (2.6.16.60-0.27-smp.x86_64)
SUSE Linux 11.1.2 for x86_64 (Kernel level 2.6.32.36-0.5-default)
SUSE Linux 11.1.4 for x86_64 (Kernel level 2.6.32.59-0.7-default)
Debian 6.0.4 for x86_64 (Kernel level 2.6.32-5-amd64)
Debian 6.0.5 for x86_64 (Kernel level 2.6.35-10-amd64)
Debian 7.8 for x86_64 (Kernel level 3.2.0-4-amd64)
CentOS 5.5 for x86_64 (Kernel level 2.6.18-194.el5.x86_64)
CentOS 5.5.1 for x86_64 (Kernel level 2.6.18-194.11.4.el5.centos.plus)
CentOS 5.8 for x86_64 (Kernel level 2.6.18-308.el5.x86_64)
CentOS 5.8.1 for x86_64 (Kernel level 2.6.18-308.1.1.el5.x86_64)
CentOS 6.2 for x86_64 (Kernel level 2.6.32-220.2.1.el6.x86_64)
CentOS 6.2 patch 13 (2.6.32-220.13.1.el6.x86_64)
CentOS 6.2 patch 27 (2.6.32-220.27.1.el6.x86_64)
CentOS 6.3 for x86_64 (Kernel level 2.6.32-279.el6.x86_64)
CentOS 6.3.1 for x86_64 (Kernel level 2.6.32-279.1.1.el6.x86_64)
CentOS 6.3.2 for x86_64 (Kernel level 2.6.32-279.2.1.el6.x86_64)
CentOS 6.3.9 for x86_64 (Kernel level 2.6.32-279.9.1.el6.x86_64)
CentOS 6.3.14 for x86_64 (Kernel level 2.6.32-279.14.1.el6.x86_64)
Page 8 of 18
Page 9 of 18
The last line of the header will contain the kernel version for which the FSD was built. Please verify that your
current kernel matches the version displayed. Use the uname r Linux command to see you kernels version
number. If the kernel version does not match then do not continue. You may have to perform some updates on
your Linux installation to acquire the required kernel version. Contact Omneon Technical Support for further
information.
omfs_build_branch = 3.4.0.0
omfs_build_date = Mon Jan 26 03:03:09 PST 2015
Page 10 of 18
1.
Harmonic MediaGrid Linux FSD 3.4 Release Notes
For Ubuntu or Debian use: "dpkg --install --force-overwrite
mediagridfsd_3.4.0.0-20140512-3.2.0-29-generic_amd64.deb".
The "--force-overwrite" option replaces the distro-provided omfs.ko module. See the note below.
For all other Linux operating systems you may use the rpm --i command by itself. For example: # rpm
ivh MediaGridFSD-3.4.0.0-20070515_2.6.17_1.2142_FC4smp.x86_64.rpm
2. Please capture the output of this command in case a problem occurs.
3. Once you have installed the rpm file, restart your client computer.
Note
Fedora, SLES, Ubuntu, and Debian distributions provide an "omfs.ko" kernel driver module which
conflicts with the Harmonic Mediagrid kernel driver module of the same name. In most cases, this is
not automatically loaded nor needed. However, you should ensure it is not already in use before
replacing it (for example, the command "lsmod | grep omfs" can be used to determine if it is loaded into
the kernel).
Installation Issues
If the rpm utility complains about a dependency mismatch, particularly about a kernel module, please check the
kernel revision level on the computer against the kernel levels listed above against each distribution. There may
be a mismatch between the kernel that the rpm is built for and the one on the machine. If this is the case, please
contact Harmonic Technical Support for assistance or a revised rpm package.
Page 11 of 18
The mount command usually loads the Linux FSD module automatically. If it does not, use the modprobe
command to force loading: # modprobe omfs
Page 12 of 18
Operational Notes
Specifying File Buffering
The Harmonic MediaGrid Linux FSD allows you to configure the number of slice buffers used per file for
read-ahead buffering. The memory used is specified in units of slices, and applies to each file opened for
access. Each slice can be 256KB to 8MB in size. This configuration is done at mount time, using the readahead
option. For example:
This command reserves 2 slices worth of memory for each file that is opened (two slices for read-ahead buffers).
The default readahead value is 3, which reserves 3 slices of memory per file. Reducing these values will
increase the number of simultaneously active files an application can use, but will reduce performance.
Increasing it may improve performance for some workflows.
The currently supported values for readahead are 0 to 50.
The Harmonic MediaGrid Linux FSD allows you to configure the total number of files open at any time through
the mount time filelimit option. For example:
This command sets the total number of simultaneously open files to 2000. The default filelimit is 1024.
Page 13 of 18
Page 14 of 18
This example will limit the Linux FSD to using only 10MB for cache memory. This parameter may also be used
in the /etc/modprobe.conf configuration file. See the Linux documentation for information on the format of this
file.
Important!
The default value for this parameter is sufficient in most cases. If you are unsure of whether you should
change it, please contact Technical Support for assistance.
The following format can be used to change this value: echo NNN > /proc/sys/omfs_cache_max_mem_MB
The cache memory limit, shown as NNN, is in Megabytes.
For settings greater than 1000MB, the omfs_cache_allocate_limit should also be increased by 4000 for each
additional MB.
Or
Where [list of interfaces] is a colon separated list of Ethernet interfaces. For example:
Page 15 of 18
Instead of listing interface names individually, you can use the allnic option to indicate use of all Ethernet
interfaces on the system.
The Linux FSD performs connection load balancing by inserting routing table entries for each ContentServer
connection. Most Linux kernels ignore routing table entries when NICs are connected to the same subnet. In
order to prevent this kernel behavior from defeating the Linux FSDs connection balancing, the following lines
must be added to the /etc/sysctl.conf file.
net.ipv4.conf.default.arp_ignore = 1
net.ipv4.conf.default.arp_announce = 1
After making these additions, reboot the computer to have them take effect.
With this capability enabled, file permission bits may be tested and manipulated through the normal Linux
interfaces. Please note that turning this capability on will reduce performance related to directory access
operations, such as directory listing.
Page 16 of 18
Description
Using PHP copy with the Linux FSD may result in the Linux FSD client becoming
copy
Issue with
When using the Linux FSD with multiple NICS that share the same subnet, file read
Multi-NIC Linux
performance may be negatively affected. As a workaround, make sure that each NIC is
Client
on a different subnet or modify the /etc/sysctl.conf configuration file on the Linux FSD
client as follows.
Add the following to /etc/sysctl.conf:
{noformat}
net.ipv4.conf.all.arp_ignore=1
net.ipv4.conf.all.arp_announce=2
{noformat}
(MG-6700)
Issue with RedHat In some cases, when running the Linux FSD on Linux RedHat 5.x, the Linux FSD client
5.x Driver
may become unresponsive and the kernel may produce the following messages
This is a known issue with RedHat 5.x. As a workaround, you can disable TSO on the
e1000 NIC with the following command, assuming eth0: ethtool -K eth0 tso off
For more information, refer to the following RedHat website:
https://bugzilla.redhat.com/show_bug.cgi?id=436966
(USM-5092)
Installation or
In some cases, when installing or upgrading the MediGrid Linux FSD, you may see an
Upgrade may
error message that indicates a conflict with the installed kernel package. The following is
Require the
--force
Command
Page 17 of 18
Issue
Description
"file /lib/modules/2.6.34.7-61.fc13.i686.PAE/kernel/fs/omfs/omfs.ko from
install of MediaGridFSD-3.0-20101129_2.6.34.7_61.fc13.i686.PAE.i386 conflicts
with file from package kernel-PAE-2.6.34.7-61.fc13.i686"
In this case, you can use the --force command or "--force-overwrite" option for "dpkg" to
allow the Linux FSD to ignore the conflict and continue installing. Type the following to
continue the FSD installation: rpm -ivh --force or for Ubuntu or Debian: dpkg -i
--force-overwrite
(MG-4749, USM-4992)
Page 18 of 18