Go to documentation repository
Documentation for Axxon One 2.0. Documentation for other versions of Axxon One is available too.
Previous page Next page
vfs_format.exe is a console utility for working with Axxon One archives. The utility is located in the <Axxon One installation directory>\bin> folder.
Attention!
- For the correct operation of the utility, you must remove the corresponding archive volume in Axxon One without removing the archive files (see Removing archive volumes).
- Run the command line as Administrator.
- To run the utility on Linux OS, run the following command: ngprun start_app vfs_tools + arguments. To open the argument list, run the vfs_tools --help command.
- 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.
The utility contains the following parameters:
Parameter | Description |
| --help | Help window |
| --volume | Archive volume path. The basic parameter must always be present in the query. For example: vfs_format.exe --volume D:\archiveAntiqueWhite.afs (for the archive volume as a file) or vfs_format.exe --volume D:\ (for the 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. 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. Use with the --fill parameter. This parameter is valid only for archives that could fit to RAM. For example: vfs_format.exe --volume S:\FILEONE.afs --fill G:\ --cache-to-memory |
| --dump | Collect service information about the 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 the archive volume metadata in a TXT file. For example: vfs_format.exe --volume D:\archiveAntiqueWhite.afs --dump-meta C:\DumpMetaArc.txt |
| --dump-fullness | Collect service information about the archive fullness in a TXT file. For example: vfs_format.exe --volume C:\archiveAliceBlue.afs --dump-fullness C:\DumpFullnessArc.txt |
| --expand | Specify the new size of the 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 the archive volume as a file. For example: vfs_format.exe --volume D:\archiveAntiqueWhite.afs --expand 128 |
--size | Specify the new size of the archive volume in megabytes. This parameter is relevant only for the 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 the archive volume into blocks of the specified size (in megabytes). For example: vfs_format.exe --volume D:\archiveAntiqueWhite.afs --format 16 |
| --copy | Copy archive volume. Specify the path and name of the new archive file. If the 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 the archive volume. This parameter is used only together with --copy. For example: vfs_format.exe --volume D:\archiveAliceBlue.afs --copy C:\NewArc.afs --skip-bad-block |
| --modify-corrupted-flag | Enable/disable reindexing of the 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 may take significant amount of time. |
| --clear-meta | Delete metadata of the archive volume. For example: vfs-format.exe --volume D:\ --clear-meta |
| --clear-data | Delete the archive volume service information (does not operate without the from and to arguments). For example: vfs_format.exe --volume C:\archiveAliceBlue.afs --clear-data --from 20220210T110000 --to 20220210T114000. --from and --to are used to set the UTC time intervals in the ISO YYYYMMDDThhmmss format. Then you must confirm the deletion |
| --log-level | Set the logging level for this action. Available values:
|
--channel | Specify the archive channel. For example: vfs_format.exe --volume=Q:/archiveAliceBlue.afs --channel=E7C79FA3-E0D4-B6CD-9307-6C24E96C305E You can force masking of the blocks for certain archive channels. Attention! Masking of blocks 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, |
| --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 |
Overview
Content Tools