Documentation for Axxon One 2.0. Documentation for other versions of Axxon One is available too.

Previous page POS terminal data collection utility  Appendices Next page

The vfs_format.exe console test utility is used to work with Axxon One archives.

Note

The vfs_format.exe utility executable file is located in the <Axxon One installation folder>\AxxonSoft\Axxon One\bin\ folder.

For the correct operation of the utility, do the following:

  1. Remove the corresponding archive volume in Axxon One without removing the archive files (see Removing archive volumes).
  2. Open vfs_format.exe as administrator.

    Note

    • To run the utility in Linux OS, run the following command:
      ngprun start_app vfs_tools + arguments
    • To open the argument list, run the following command:
      vfs_tools --help
  3. Enter the required query using the parameters:

    Attention!

    To log error messages, you must add the path for the log file at the end of each query.
    For example, vfs_format.exe --volume S:\FILEONE.afs --fill G:\ --log-level=100 > S:\log.txt.

Parameter

Description

--help

Help window

--volume

Path to an archive volume. The basic parameter, it must always be present in the query.

For example: vfs_format.exe --volume D:\archiveAntiqueWhite.afs (for an archive volume as a file) or vfs_format.exe --volume D:\ (for an archive volume as a disk)

--fill

Multiple filling of an archive with data from another archive. The system fills up a destination archive or a volume with multiple copies of a source archive or a volume in a loop. For easier timeline handling, each new copy is written with one minute offset.

For example: vfs_format.exe --volume S:\FILEONE.afs --fill G:\ 

--cache-to-memory

Copy an archive to RAM and further copy to a destination archive. Used together with the --fill parameter. This parameter is valid only for archives that can fit to RAM.

For example: vfs_format.exe --volume S:\FILEONE.afs --fill G:\ --cache-to-memory

--dump

Collect service information about an archive volume in a TXT or XML file.

For example: vfs_format.exe --volume D:\archiveAntiqueWhite.afs --dump C:\DumpArc.txt

--dump-meta

Collect service information about metadata of an archive volume in a TXT file.

For example: vfs_format.exe --volume D:\archiveAntiqueWhite.afs --dump-meta C:\DumpMetaArc.txt

--dump-fullness

Collect service information about fullness of an archive in a TXT file.

For example: vfs_format.exe --volume C:\archiveAliceBlue.afs --dump-fullness C:\DumpFullnessArc.txt

--expand

Specify a new size of an archive volume in blocks. By default, the size of one block is 4MB if the --format parameter was not applied. This parameter is relevant only for an archive volume as a file.

For example: vfs_format.exe --volume D:\archiveAntiqueWhite.afs --expand 128

--size

Specify a new size of an archive volume in megabytes. This parameter is relevant only for an archive volume as a file.

For example: vfs_format.exe --volume D:\archiveAntiqueWhite.afs --size 4096

Attention!

  • The value of the --size parameter must be a positive integer.
  • The value of the parameter must not contain spaces, characters, or punctuation marks.
--format

Split an archive volume into blocks of the specified size (in megabytes).

For example: vfs_format.exe --volume D:\archiveAntiqueWhite.afs --format 16

--copy

Copy an archive volume. Specify the path and name of a new archive file. If an archive volume is copied as a disk, create a partition without formatting, larger than the copied volume. If you have a smaller partition, then only the most recent entries are copied.

For example: vfs_format.exe --volume D:\archiveAntiqueWhite.afs --copy C:\NewArc.afs

--skip-bad-block 

Skip the bad blocks when copying an archive volume. This parameter is only used together with the --copy parameter.

For example: vfs_format.exe --volume D:\archiveAliceBlue.afs --copy C:\NewArc.afs --skip-bad-block

--modify-corrupted-flag 

Enable/disable reindexing of an archive volume. 1—enable reindexing, 0—disable.

For example: vfs_format.exe --volume D:\archiveAliceBlue.afs --modify-corrupted-flag 1

--build-meta

Launch the process of metadata generation of an archive volume (including timeline markers and video footage size per channel).

For example: vfs-format.exe --volume D:\ --build-meta

Attention!

Processing large archives can take significant amount of time.

--clear-meta

Delete metadata of an archive volume.

For example: vfs-format.exe --volume D:\ --clear-meta

--clear-data

Delete service information of an archive volume (does not operate without the --from and --to arguments). --from and --to are used to set the UTC time intervals in the ISO YYYYMMDDThhmmss format. Then you must confirm the deletion.

For example: vfs_format.exe --volume C:\archiveAliceBlue.afs --clear-data --from 20220210T110000 --to 20220210T114000

--log-level

Specify the logging level of the operation being performed. Available values:

  • 0—OFF,
  • 10—ERROR,
  • 20—WARN,
  • 40—INFO (recommended),
  • 50—DEBUG,
  • 60—TRACE,
  • 100—ALL

--channel

Specify the archive channel.

For example: vfs_format.exe --volume=Q:/archiveAliceBlue.afs --channel=E7C79FA3-E0D4-B6CD-9307-6C24E96C305E

You can perform forced block masking for certain archive channels.

Attention!

Block masking is available only if the archive volume is disabled.

For example: vfs_format.exe --volume=Q:/archiveAliceBlue.afs --channel=E7C79FA3-E0D4-B6CD-9307-6C24E96C305E --clear-from=20350101T000000 --clear-to=20370101T000000,

where 

  • --clear-from—start interval in the YYYYMMDDThhmmss format,
  • --clear-to—end interval in the YYYYMMDDThhmmss format
--recover

Recover the last recording layer after formatting the archive. This parameter is relevant only if there were records after the last formatting.

For example: vfs_format.exe --volume E:\ --recover

--recover=2

Recover the last recording layer after formatting the archive.

For example: vfs_format.exe --volume E:\ --recover=2 after the archive formatting, or vfs_format.exe --volume E:\archiveAliceBlue.afs --recover=2 after the disk formatting


  • No labels