IBM Support

How to Restore User-Defined File Systems (UDFS) Data if Save was Done with File System Mounted or Unmounted

Troubleshooting


Problem

This document explains the steps necessary to save and restore User-Defined File Systems (UDFS) data.

Resolving The Problem

This document explains the steps necessary to save and restore User-Defined File Systems (UDFS) data.

A user-defined file system (UDFS) is a file system that can be created and managed by a user. Multiple UDFSs with unique names can be created on the system. The ASP number is determined by the directory that contains the UDFS. For example, '/dev/QASP01/MyUdfs1.udfs' indicates that MyUdfs1 is in the system ASP. The file name '/dev/MyIASP/MyUdfs2.udfs' indicates MyUdfs2 is in the independent disk pool MyIASP. A UDFS named QDEFAULT.udfs is created automatically when any IASP is created. For example, '/dev/MyIASP/QDEFAULT.udfs'

User-defined file system (UDFS) can be saved when it is mounted or unmounted. Ordinarily, you should unmount user-defined file systems (UDFS) before save and restore operations. Menu Options 21, 22, and 23 of the GO SAVE command provide an option to unmount UDFSs before the save operation. Note: To save UDFS when it is on an independent disk pool, you should ensure that the independent disk pool is varied on and that the UDFS is unmounted before you start the save operation or set to unmount during the save..

To save an unmounted UDFS, specify the following command:
SAV OBJ(('/dev/QASP02/udfs_name.udfs')) where QASP02 represents basic system ASP 2
or
SAV OBJ(('/dev/IASP01/QDEFAULT.udfs')) where IASP01 is a independent ASP

The system saves information about the UDFS (for example, the ASP number, authority, and case sensitivity).

To save a mounted UDFS, specify the following command:
SAV OBJ(('/directory_mounted_over')

Note: In this example, the UDFS was mounted over directory '/directory_mounted_over' when directory '/directory_mounted_over' was saved.

InfoCenter link :
V7R1: http://www.ibm.com/support/knowledgecenter/ssw_ibm_i_71/rzaiu/rzaiurzaiu158.htm

Restoring UDFS different commands should be used if UDFS was saved mounted or unmounted.

    • - Restore UDFS if backup was done with file systems unmounted



      If the backup was done when file systems were unmounted (which is recommended), UDFS should be unmounted during restore operation:

      1.Check if UDFS is mounted:
      DSPUDFS UDFS('/dev/QASPxx/MyUdfs.UDFS')
      or
      DSPUDFS UDFS('/dev/myIASP/QDEFAULT.udfs')
      2. If UDFS is mounted, use command UNMOUNT for each UDFS that needs to be restored.
      UNMOUNT TYPE(*UDFS) MNTOVRDIR('/directory_mounted_over')
      3.Restore UDFS using the following command:
      RST OBJ(('/dev/QASPxx/MyUdfs.UDFS'))
      or
      RST OBJ(('/dev/myIASP/QDEFAULT,UDFS'))

      If the UDFS does not exist on the system, the system creates the block special file (*BLKSF) object that represents the UDFS. If the UDFS does exist, objects from the save media overlay objects on the system. During disaster recovery, auxiliary storage pools (ASPs) that contain the UDFS must be created before the restore operation. If ASPs is not created, the system does not restore the UDFSs.

      InfoCenter link : http://publib.boulder.ibm.com/infocenter/iseries/v7r1m0/index.jsp?topic=%2Frzarm%2Frzarmrzaiu162.htm
      • - Restore individual object if UDFS were unmounted during backup



        Even if UDFS were unmounted during backup, it is possible to restore individual objects.
        To perform the task, the name of the object that needs to be restored should be specified. The parent directory of the new name must exist in an accessible file system.


        To restore an individual object from the UDFS that was saved unmounted into a "normal" (for example, non-UDFS) directory, use the following command(s):

        1.Create target directory:
        CRTDIR DIR('/MyRestoreDir')
        2.Restore object named "obj" using the following command:
        RST OBJ(('/dev/QASPxx/MyUdfs.UDFS/obj' *INCLUDE '/MyRestoreDir/obj'))

        To restore an individual object back into UDFS, the UDFS must be mounted before restore:
        1.Check if UDFS is mounted:
        DSPUDFS UDFS('/dev/QASPxx/MyUdfs.UDFS')
        2. If UDFS is unmounted use following command
        MOUNT TYPE(*UDFS) MFS('/dev/QASPxx/MyUdfs.UDFS') MNTOVRDIR('/directory_mounted_over')
        3.If target object is already present use command
        RMVLNK OBJLNK('/directory_mounted_over/obj')
        4.Restore object named "obj" using following command:
        RST OBJ(('dev/QASPxx/MyUdfs.UDFS/obj' *INCLUDE '/directory_mounted_over/obj'))

        InfoCenter link: http://publib.boulder.ibm.com/infocenter/iseries/v7r1m0/index.jsp?topic=%2Frzarm%2Frzarmrzaiu163.htm
        • - Restore UDFS if backup was done with file system mounted



          If the backup was done when file systems were mounted, UDFS must be mounted during restore.
          If file system is not mounted, the directories are restored to the SYSBAS instead of IASP.

          1.Check if the file system is mounted using command DSPUDFS:
          DSPUDFS UDFS('/dev/QASPxx/MyUdfs.UDFS')
          2.If UDFS is unmounted, use following command:
          MOUNT TYPE(*UDFS) MFS('/dev/QASPxx/MyUdfs.UDFS') MNTOVRDIR('/directory_mounted_over')
          3.To restore the objects within the mounted UDFS, specify the following command:
          RST OBJ(('/directory_mounted_over'))

          The system restores the objects into the file system of the parent directory to which the objects are restored. The system does not restore the UDFS object: '/dev/QASPxx/MyUdfs.udfs'.

          If UDFS is not present during restore operation, you should use the RBDMFS(*UDFS) parameter on the RST command to rebuild the mounted UDFS during the restore operation; otherwise, only the objects contained in the directory are restored, and none of the UDFS information is restored:

          RST OBJ(('/directory_mounted_over')) RBDMFS(*UDFS)

          InfoCenter links:
          http://publib.boulder.ibm.com/infocenter/iseries/v7r1m0/index.jsp?topic=%2Frzarm%2Frzarmrzaiu167.htm
          http://publib.boulder.ibm.com/infocenter/iseries/v7r1m0/index.jsp?topic=%2Frzarm%2Frzarmrestoremountedudfs.htm

        [{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"}]

        Historical Number

        659412062

        Document Information

        More support for:
        IBM i

        Software version:
        7.1.0

        Operating system(s):
        IBM i

        Document number:
        683773

        Modified date:
        18 December 2019

        UID

        nas8N1010543

        Manage My Notification Subscriptions