Running a Hot Backup

Note: Hot backups are only available if you have advanced logging enabled.
  1. At the command prompt, type FSVIEW.

    The FSVIEW Administration Utility is started.

  2. To log on to supervisor mode, type admin logon <username> <password>, where <username> and <password> are your Fileshare logon credentials.
  3. To log on to the server, type server set <server-name>, where <server-name> is the name of the Fileshare server.
  4. Type backup init.

    Fileshare now only processes file operations for in-flight transactions. While these transactions are being processed, you can enter backup cancel at the FSVIEW prompt to cancel the backup.

  5. When all sessions have been processed, control is passed to the 78-transactions-newlog clause in fsexitproc.cbl.

    when 78-transactions-newlog
        *> Fileshare is ready to create a new log. 
         *> used when roll forward logging is enabled.
         *> default it to start new log
         *> set action to determine what occurs..
         *> don't start new log     value h"0000".
         *> start new log           value h"0001".
    continue
    At this point, the log file is finalized, the data files are flushed to disk, and if the default action is set, a new log file is created.
    Note: Any new requests are cycled until the backup has completed; ensure Fileshare clients do not time out during this period by setting CCI TIMEOUT to a sufficient period of time; see Best Practices for Advanced Logging for more details.
  6. When the files are ready, control then moves to the 78-transactions-suspended clause in fsexitproc.cbl.
    Note: fsexitproc.cbl contains an example of how the backup can be taken using the Diskshadow utility (see below) and a script file example. Update this clause to run your preferred utility.
    when 78-transactions-suspended
       call "CBL_EXEC_RUN_UNIT"
          using "diskshadow.exe /s script.dsh "
                           by value  52
                           by reference runit-run-id
                           by value     runit-stack-sz
                                        runit-flags
                    returning return-code
       continue
    
    The accompanying script file example
    *> Example script.dsh for use with diskshadow.exe (Windows)
    #DiskShadow script file
    set context persistent nowriters
    set metadata c:\diskshadowdata\example.cab
    set verbose on
    begin backup
    add volume d: alias SystemVolumeShadow
    
    create
    unexpose p:
    expose %SystemVolumeShadow% p:
    end backup
    *> #End of script

    When the snapshot has been taken, Fileshare resumes normal transaction processing.

  7. You should now copy the data files from the snapshot to a safe location.