Rename a StorNext filesystem

This process had been verified for StroNext versions 3.5.x and 4.2.x.  Versions 4.3 is a little different and work is in process to document it, see bottom of article.

The following info is for .cfg based configuration files, for newer .cfgx based this is still pretty close, for full official write up for .cfgx please refer to StorNext User Guide and search for 'rename'.

(from Quantum Knowledge Base article 1272)

How to rename a standalone (unmanaged) StorNext file system

Use this procedure to change the name of a StorNext file system.

This is only for StorNext file systems that do not have the Tertiary Storage Manager (TSM) component installed.

1. Unmount the file system from all the client systems using it.
2. Stop the file system in cvadmin.
3. Run cvfsck with the following parameters:
   cvfsck -j file_system_name
   cvfsck -n file_system_name
   where file_system_name is the actual name of your file system.
   Make sure that cvfsck says that the file system is clean.
4. Do one of the following:
• If cvfsck detects no file system errors, go to the next step.
• If cvfsck detects file system errors, run it in a "fix" mode
  cvfsck file_system_name
5. Rename the file_system_name.cfg file and edit the fsmlist file to reflect the new file system name.
   By default, these files reside in the /usr/cvfs/config directory on UNIX systems and in the C:\SNFS\config folder on Windows systems.
6. Run cvfsck in interactive mode to remake icb by typing cvfsck without double quotes.
   The system asks what file system to check. Here is a sample screenshot:
   [root@testbox]# cvfsck
   StorNext File System File Systems on host testbox:
   
   1) *snfs1
   2) *snfs2
   The asterisk (*) denotes the file system is active.
   
   Choose a file system by number (1-2) or zero (0) to exit
   
   Run it against the file system that has a new name.
7. During its run, cvfsck senses that there is an icb mismatch and asks if you want to fix the mismatch. Type yes.
8. Make adjustments to the /etc/vstab and /etc/fstab files, as well as in the Windows StorNext User Interface to reflect the new file system name on all the systems involved.
9. Start the file system and make it active (cvadmin).
10. Mount the file system.

Output of StorNext 4.3.1

This is NOT an approved process yet, just for informational during KB update.

Note: have to cvfsck two time, 1st time to create the directories for the newly named filesystem, 2nd time to actually update the icb.

[root@mds1-120110008 config]# cvfsck newerbarry
Checked Build disabled - default.

BUILD INFO:
#!@$ Revision 4.3.1 Build 27634 Branch branches_4.3.1
#!@$ Built for Linux 2.6.32-71.el6.x86_64 x86_64
#!@$ Created on Wed Sep  5 02:53:07 MDT 2012



Re-creating File System Directory '/usr/cvfs/data/newerbarry'.


Re-creating File System Log Directory '/usr/cvfs/data/newerbarry/log'.

Re-creating File System cvfsck Directory '/usr/cvfs/data/newerbarry/trace'.

*Warning*: Inode Expand Min is deprecated and will no longer be supported in future releases
*Warning*: Inode Expand Max is deprecated and will no longer be supported in future releases
*Warning*: Inode Expand Inc is deprecated and will no longer be supported in future releases
    elapsed time: 0.02 seconds total

*Warning*: Icb has a configuration mismatch!
Icb mismatches configuration:
  File System Name Mismatch. exp-newerbarry rcv-barry

*Fatal*: The Information Control Block (ICB) has been corrupted. Allowing
cvfsck to continue could result in permanent data loss. It is highly
recommended that you call Quantum Technical Support and request assistance.
If you would like to continue, please run this program in interactive mode
to repair the ICB.

*Critical*: File System Check finished - with errors.

cvfsck total elapsed time: 0.02 seconds total (delta 0.00 seconds)
[root@mds1-120110008 config]# cvfsck newerbarry
Checked Build disabled - default.

BUILD INFO:
#!@$ Revision 4.3.1 Build 27634 Branch branches_4.3.1
#!@$ Built for Linux 2.6.32-71.el6.x86_64 x86_64
#!@$ Created on Wed Sep  5 02:53:07 MDT 2012


*Warning*: Inode Expand Min is deprecated and will no longer be supported in future releases
*Warning*: Inode Expand Max is deprecated and will no longer be supported in future releases
*Warning*: Inode Expand Inc is deprecated and will no longer be supported in future releases
    elapsed time: 5.03 seconds total

*Warning*: Icb has a configuration mismatch!
Icb mismatches configuration:
  File System Name Mismatch. exp-newerbarry rcv-barry

*Fatal*: The Information Control Block (ICB) has been corrupted. Allowing
cvfsck to continue could result in permanent data loss. It is highly
recommended that you call Quantum Technical Support and request assistance.
If you would like to continue, please run this program in interactive mode
to repair the ICB.

*Critical*: File System Check finished - with errors.

cvfsck total elapsed time: 5.03 seconds total (delta 0.00 seconds)

 

 

 

[root@mds1-120110008 config]# cvfsck
Checked Build disabled - default.

BUILD INFO:
#!@$ Revision 4.3.1 Build 27634 Branch branches_4.3.1
#!@$ Built for Linux 2.6.32-71.el6.x86_64 x86_64
#!@$ Created on Wed Sep  5 02:53:07 MDT 2012

StorNext File Systems on host mds1-120110008:

1)  newerbarry
2)  rebarry

Choose a file system by number (1-2) or zero (0) to exit -> 1


** WARNING ** This file system check may modify the meta-data of the

              --- [newerbarry] ---

              file system. This procedure cannot be un-done!

Do you want to proceed? (Y/N) -> y



*Warning*: Inode Expand Min is deprecated and will no longer be supported in future releases
*Warning*: Inode Expand Max is deprecated and will no longer be supported in future releases
*Warning*: Inode Expand Inc is deprecated and will no longer be supported in future releases
    elapsed time: 1.43 seconds total

*Warning*: Icb has a configuration mismatch!
Icb mismatches configuration:
  File System Name Mismatch. exp-newerbarry rcv-barry

** WARNING ** The Information Control Block (ICB) for file system

               --- [newerbarry] ---

              appears to have significant corruption. Allowing cvfsck
              to continue could result in permanent data loss. It is highly
              recommended that you call Quantum Technical Support and
              request assistance. If you allow cvfsck to proceed, it will
              attempt to correct the corruption. This procedure cannot be
              un-done!

Do you want to proceed? (Y/N) -> y

Fixing corrupted Icb.
ICB fsmarker is wrong. Attempting repair...
Successful ICB recreation.

Created directory /tmp/cvfsck8231a for temporary files.

Attempting to acquire arbitration block... successful.


    elapsed time: 12.31 seconds total (delta 10.88 seconds)
Creating MetaFiles allocation check file.
Creating DataFiles_0 allocation check file.
Creating DataFiles_1 allocation check file.
Creating DataFiles_2 allocation check file.

Recovering Journal Log.

    elapsed time: 12.60 seconds total (delta 0.29 seconds)
Beginning scan of newerbarry file system

Super Block information.
  FS Created On               : Sat Apr 27 07:56:22 2013
  Inode Version               : '2.6' - 4.0 inode version with big inodes (0x206)
  File System Status          : Clean
  Allocated Inodes            : 16896
  Free Inodes                 : 16750
  FL Blocks                   : 4
  Next Inode Chunk            : 0x6cc8
  Metadump Seqno              : 0
  Restore Journal Seqno       : 0
  Client Write Opens Inode    : 0x7

Stripe Group MetaFiles                      (  0) 0x8b8c750 blocks.
Stripe Group DataFiles_0                    (  1) 0x45c5f00 blocks.
Stripe Group DataFiles_1                    (  2) 0x45c5f00 blocks.
Stripe Group DataFiles_2                    (  3) 0x45c5f00 blocks.

    elapsed time: 12.60 seconds total (delta 0.00 seconds)

Inode block size is 1024

Building Inode Index Database 16896 (100%).        
   16896 inodes found out of 16896 expected.

Inode Summary:
   total inodes    16896
   free inodes     16750
   metadata        5
   extender inodes 0
   bad inodes      0

   files           137
   directories     2
   symlinks        0
   xattrs          0
   named streams   0
   block devs      0
   char devs       0
   fifos           0
   sockets         0

   hardlinks       0
   largest dir     137 entries
   largest dir     3 blocks
   largest file    3128 blocks

File allocations
   empty files     0
   less than 512KB 0
   less than 1MB   0
   less than 512MB 137
   less than 1GB   0
   less than 512GB 0
   less than 1TB   0
   less than 1PB   0
   1PB or greater  0

    elapsed time: 12.73 seconds total (delta 0.14 seconds)

    elapsed time: 12.73 seconds total (delta 0.00 seconds)

Verifying Free List Extents.

    elapsed time: 12.73 seconds total (delta 0.00 seconds)

Scanning inodes 16896 (100%).          

    elapsed time: 13.13 seconds total (delta 0.40 seconds)

Sorting extent list for MetaFiles pass 1/1
Updating bitmap for MetaFiles extents 8 (  5%).                    
Sorting extent list for DataFiles_0 pass 1/1
Updating bitmap for DataFiles_0 extents 92 ( 63%).                    
Sorting extent list for DataFiles_1 pass 1/1
Updating bitmap for DataFiles_1 extents 145 (100%).                    

    elapsed time: 13.13 seconds total (delta 0.00 seconds)

Checking for dead inodes 16896 (100%).          

    elapsed time: 13.19 seconds total (delta 0.06 seconds)

Checking directories 2 (100%).         

    elapsed time: 13.26 seconds total (delta 0.07 seconds)

Scanning for orphaned inodes 16896 (100%).        

    elapsed time: 13.34 seconds total (delta 0.08 seconds)

Verifying link & subdir counts 16896 (100%).          

    elapsed time: 13.40 seconds total (delta 0.06 seconds)

Checking free list. 16896 (100%).          
Checking pending free list.                        

    elapsed time: 13.53 seconds total (delta 0.13 seconds)

Checking Arbitration Control Block.

    elapsed time: 13.53 seconds total (delta 0.00 seconds)

Checking MetaFiles allocation bit maps (100%).         
Checking DataFiles_0 allocation bit maps (100%).         
Checking DataFiles_1 allocation bit maps (100%).         
Checking DataFiles_2 allocation bit maps (100%).         

    elapsed time: 13.65 seconds total (delta 0.12 seconds)

File system 'newerbarry'. Blocks-219487488 free-219031249 Inodes-16896 free-16750.

File System Check completed successfully.

cvfsck total elapsed time: 13.67 seconds total (delta 0.02 seconds)
[root@mds1-120110008 config]#