OneFS Upgrades - Isilon Info Hub

Welcome to the EMC Isilon OneFS Upgrades Information Hub. Here you can find links to important OneFS upgrade resources and product announcements.

 

The following sections provide an overview of the upgrade process and the documentation and resources that are required to complete each step of the upgrade process. To successfully plan for and perform a OneFS upgrade, you must follow the procedures detailed in the OneFS Upgrade Planning and Process Guide. There are two versions of this guide. Choose the version that applies to the version of OneFS that you are upgrading from:

 

Upgrade Planning and Process Guides

 

Important: If you have a performance-sensitive workload, consult your Sales Engineer during the pre-upgrade planning process.


If you are upgrading from OneFS 7.x to a later version, use this guide:


If you are upgrading from OneFS 8.x to a later version, use this guide:

 

 

Couldn't find the information that you were looking for, or have suggestions for improving this page? Let us know! We're eager to help. You can add a comment below or complete this brief survey.


If you're upgrading from OneFS 6.5, check out the OneFS 6.5 Upgrade - Isilon Info Hub for more information.

 

OneFS upgrades require the following phases:

 

  1. Planning for an upgrade
  2. Pre-upgrade tasks
  3. Performing the upgrade process
  4. Post-upgrade tasks

 

Phase 1: Planning for an upgrade

 

IMPORTANT: Intermediate upgrades must be treated like full upgrades, with all the recommended planning and preparations that apply. If you must upgrade to an intermediate version of OneFS before you can upgrade to the desired target version, complete the pre-upgrade and post-upgrade steps in the OneFS Upgrade Planning and Process Guide first for the intermediate upgrade, and then complete the pre-upgrade and post-upgrade steps again for the upgrade to the target version. Follow the instructions in the version of the OneFS Upgrade Planning and Process Guide that matches the OneFS version that you are upgrading from.

 

Recommended: We strongly recommend that you engage the services of the EMC Remote Proactive team (link requires login to EMC Online Support). The EMC Remote Proactive team provides the expertise for a safe and smooth remote upgrade. Premium Support customers are entitled to this service. All other customers can request this service at the cost of time and materials. Contact your Isilon account team for more information.

 

If you choose not to request this service, you must follow all of the procedures detailed in the OneFS Upgrade Planning and Process Guide.

 

Required documentation

 

 

Evaluating the health of your cluster

 

Recommended: Run the Isilon Self-Service Platform (SSP) diagnostic tool before and after upgrading OneFS. This tool includes pre- and post-upgrade checks and can be used to assess the health of the cluster.

 

The Isilon SSP diagnostic tool is an off-cluster log analyzer that inspects and reports on cluster logs. The SSP is the same tool that EMC Isilon Technical Support and EMC Isilon field representatives use to identify, troubleshoot, and prevent a wide range of known issues that occur on Isilon clusters.

 

To download the SSP diagnostic tool and the SSP User Guide, go to the Self-Service Platform (SSP) - Isilon Info Hub.

 

Back to top

 

Phase 2: Pre-upgrade tasks

 

Before upgrading OneFS, you must complete several pre-upgrade tasks. If you don't complete these pre-upgrade tasks, there is an increased risk of an upgrade failure.

 

Pre-upgrade tasks to complete: check cluster readiness, verify configuration settings, upgrade compatibility check, back up data, collect cluster data, complete or stop jobs in progress, update drive firmware, disconnect client connections, and activate a Support gateway.

 

  • OneFS Upgrade Planning and Process Guide (provides information about how to update firmware and other required pre-upgrade steps)
  • Article 480190, After upgrading to OneFS 8.0.0.0, SMB shares and NFS exports are no longer available
  • Article 89232, Configuring sysctls and making sysctl changes persist through node and cluster reboots and upgrades
  • Article 88766, Patches to provide pre-upgrade configuration checks for OneFS 6.5.4 and 6.5.5.0 - 6.5.5.9 upgrades to OneFS 7.0 or 7.1
  • Article 89525, OneFS 7.0 and 7.1 Pre-Upgrade Check Utility


Important: If your cluster is running Drive Firmware Package 1.7 or earlier, you must update the drive firmware to 1.8 or later before upgrading OneFS. For details, see ETA 193819. For the latest firmware versions and release notes, see the Isilon Uptime Info Hub.

 

Back to top

 

Phase 3: Performing the upgrade process

 

OneFS can be upgraded in one of two ways. A simultaneous upgrade upgrades OneFS and restarts all of the nodes in the cluster at the same time. A rolling upgrade upgrades OneFS and restarts each node in the cluster sequentially.

 

Note: Rolling upgrades are not available for some OneFS versions. To determine if a rolling upgrade is available, read the release notes for the version of OneFS that you are upgrading to.

 

Download the OneFS image

 

 

Perform the upgrade

 

 

Back to top

 

Phase 4: Post-upgrade tasks

 

After an upgrade, you should perform a number of restoration and change management tasks to help ensure that your cluster performs and behaves as expected.

 

IMPORTANT: You must allow upgrade-related jobs to run to completion. After the upgrade, a number of upgrade-related jobs will continue to run for a while. These jobs might include an important Upgrade job that redistributes, or stripes, data more efficiently.

 

Post-upgrade tasks to complete: reestablish user privileges; restore client connections and custom settings; configure base directories for access zones; reconfigure SMB shares, home directory templates, and HDFS settings within access zones; verify Kerberos migration; update SMB auditing; re-install Aspera, and update custom scripts.

 

 

Back to top

 

Related knowledge base articles

 

The following knowledge base articles require login to EMC Online Support.

 

IMPORTANT: If you're upgrading to OneFS 8.0.0.0 and you use ESRS, see Article 476541, ESRS Information Needs to be Re-entered After Upgrade to OneFS 8.0.0.0, for important post-upgrade steps.

 

  • NEW! Article 489540, Isilon OneFS: Problems with upgrading STIG-hardened clusters to OneFS 8.0.1.0
  • NEW! Article 490912, OneFS 8.0: Smartpools jobs do not run following an upgrade to OneFS 8.0.0.0 - 8.0.0.2
  • Article 483840, ETA 483840: Isilon OneFS: Isilon OneFS: Non-UTF-8 encoded files or directories may be inaccessible to NFSv3 and NFSv4 clients after upgrading OneFS clusters from version 7.1.x or earlier to 7.2.0.0 or later
  • Article 480672, After upgrading to OneFS 8.0.0.0, clients that rely on Kerberos authentication cannot be authenticated to the cluster
  • Article 480443, Protection settings are set back to managed by smartpools after upgrade from OneFS 6.5 to OneFS 7.x
  • Article 480190, After upgrading to OneFS 8.0.0.0, SMB shares and NFS exports are no longer available
  • Article 476541, ESRS information needs to be re-entered after upgrading to OneFS 8.0.0.0.
  • Article 465155, OneFS 7.2: After rolling upgrade, ESX hosted VMware virtual machines connected to an Isilon NFS datastore are unable to able to vMotion or snapshot
  • Article 459864, OneFS 7.1.1 and later: Upgrade Prevents Access Zones from being configured
  • Article 201217, OneFS 7.1.1.3: Isilon nodes that have the L3 cache feature may be unable to load their journals and complete the boot process following an upgrade to OneFS 7.1.1.3
  • Article 196297, Post Upgrade 6.5.X to 7.1.X clients are unable to create Symlinks on Isilon cluster
  • Article 192266, OneFS 7.1.1 and later: Upgrade Prevents Access Zones from being configured
  • Article 91221, Aspera Enterprise Server application is stopped after upgrading to OneFS 6.5 or later
  • Article 89232, Configuring sysctls and making sysctl changes persist through node and cluster reboots and upgrades
  • Article 89298, OneFS upgrade fails when the Isilon web administration interface becomes unresponsive


Other resources

 

 

Isilon Info Hubs