The as-convert Utility

The as-convert utility converts ActiveSpaces shared-nothing files from one format (or one version) to another (usually higher).

The utility does the following:

  • If a file name is provided, processes that file and prints out the result.
  • If a space name is provided along with the metaspace name, converts all files that belong to that space.
  • If a member name is provided along with the space name and metaspace name, converts files for that member only.
  • If a metaspace name is provided, the utility does the above for each space that is part of the metaspace.
  • If no argument is provided, processes the entire data store — reads each subdirectory and converts all files.

The dry_run option will just touch the files and identify the files that are older than the current version. This option is good for estimating how many files need conversion.

If you are upgrading from release 2.0.x to release 2.1.x or higher, then you must run the as-convert utility to upgrade shared-nothing persistence files to the format for newer releases. The as-convert.exe file is located in the following directory: AS_HOME/bin

Note: Before you run as-convert, stop all as-agents and seeders. The as-convert utility must be run off-line.

Command Syntax 

as-convert -data_store <directory_path> -metaspace <metaspace_name> -space <space_name> 
-member_name <membername> -file <file_name> -compact -dry_run -verbose -log <log_file> -debug <log_level>

The following table describes the parameters for as-convert.

Parameters for as-convert
Parameter Usage
-data_store directory_path specifies the path to the data store to convert.
-metaspace To specify conversion of the data files for all of the spaces defined for a metaspace, specify a metaspace name.
-space To specify conversion of the data files for a specific space within the metaspace, specify the space name with the -space parameter and the metaspace name with the -metaspace parameter.
-member_name To specify conversion of the data files for a specific space member, specify the member name with the -member_name parameter, the space name with the -space parameter, and the metaspace name with the -metaspace parameter.
-file To specify conversion of a specific file, specify the filename with the -file parameter, the data store path with the -data_store parameter, and the metaspace name with the -metaspace parameter.
-compact Deletes any white spaces in converted file. White spaces can be added to the data file as a result of processing Takes, which delete data.
-dry_run To run the utility without actually converting the data store and output informational messages, include the -dry_run parameter.
-help Outputs a summary of the command syntax for as-convert.
-verbose Causes output of more information.
-log Specifies the name of a log file to which to write log information
-debug Specifies the log level for messages output by the utility.