OneFS 7.1 - 7.2: How to use the isi_encoding_update command

Introduction

The isi_encoding_update command enables you to update encoding tags for files and directories that are affected by the issue described in 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

isi_encoding_update

You can use the isi_encoding_update command to do the following:

• Update the encoding tags of all entries in a directory tree to a single target encoding.
• Revert the changes made by the command.
• Create a dry-run directory tree so that you can assess the result of running the command without impacting your production environment.

Procedure

1. Before running the isi_encoding_update command, review 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  to determine whether your cluster might be affected by the issue described in the ETA.
2. If your cluster might be affected by the issue described in the ETA, run the EncodingCheck job engine job to identify any files and directories that are affected by the issue.
   
   The EncodingCheck job is included in the following OneFS releases:
    
   • OneFS 7.2.1.4 and later 7.2.1 releases
   • OneFS 7.1.1.11
   
   In addition, Dell EMC Isilon engineering released several patches for earlier OneFS releases. 
    
3. After you have identified the affected files and directories by running the EncodingCheck job, if necessary, add the isi_encoding_update command to OneFS by installing patch-178493. The patch can be installed on the following OneFS releases:
    
   • OneFS 7.1.0.5
   • OneFS 7.1.1.0 through OneFS 7.1.1.9
   • OneFS 7.2.0.0 through OneFS 7.2.0.5
   • OneFS 7.2.1.1 through OneFS 7.2.1.4
   
   The isi_encoding_update command is included in the following OneFS releases:
    
   • OneFS 7.2.1.5
   • OneFS 7.1.1.11
      
4. Run the isi_encoding_update command.

   You can run the command with one or more of the options listed in the table below:

   Option	Use
   --path	Update encoding tags on entries in the directory specified by the path.
   --encoding	Update encoding tags to target encoding. See the Supported encodings section for a list of the encoding you can use with this option.
   --list	List all successful runs of this command.
   --view	View run details by ID.
   --skip_mtime_gt	Skip files with an mtime that exceeds the value assigned to this option.
   --hard	Used with the --path option to update encoding tags of files located in the directory specified by the path. If this option is used, the command does not create a copy of the directory.
   --revert	revert changes of previous run by ID

    

   Examples

   To update the encoding tags of entries in a directory, run the following command, where <path> is the path to the directory, and <encoding> is the target encoding you want to assign to the entries:

   isi_encoding_update --path <path> --encoding <encoding>

   By default, the preceding command updates the encoding tags on a copy of the specified directory. To update the encoding tags on the specified directory, use the --hard option as follows:

   isi_encoding_update --path <path> --encoding <encoding> --hard

   To revert the changes made by the command, run the following command with the --revert option, where <id> is the runID number of the isi_encoding_update run you want to revert:

   isi_encoding_update --revert <id>

Supported encodings

The DISPLAY NAME column in the following table contains the encoding names that appear in the OneFS web administration interface. The VALID VALUES column contains the corresponding values that you can assign to the --encoding option.