Migrating SMAT database files

If you do not require migrating SMAT when you migrate your sites with hcirootcopy but require access to the SMAT database files, then use hcirootcopy to migrate only the SMAT database files.

When hcirootcopy is not used for the SMAT migration, you can use hcismatcrypt to migrate SMAT.

By default, hcirootcopy copies all the SMAT database files to the new site and then migrates them.

If option -N is specified, then it does not do the copy and migration. In this instance, use hcismatcrypt to manually migrate the SMAT database files.

Usage:

hcismatcrypt migrate [options]

Options are:

  • smatdbName/smatdbDir:

    This is the SMAT database name or directory.

    If it is a directory, then all *.smatdb files under Dir are migrated.

  • smatdbKey:

    This is the encryption key.

  • hcismatcrypt -H:

    This lists all available commands.

Note: You can also send the CLAPI request using the cURL command.

For additional information, see:

In CIS 19.1 and later, CL-API hcismatcrypt can be configured in allow list databases and run by CL_API. To do this, use these steps:

  1. Ensure CLAPI and the CLAPI document are enabled. The administrator can verify this on the ServerAdmin > Web Server tab.
  2. Locate the smatdb to migrate, and get the absolute file path. For example, C:\cloverleaf\cis19.1\integrator\testmigrate\case1.smatdb.
  3. If the CLAPI document is enabled, then open the swagger-UI page using https://hostname:15047/clapi/swagger-ui.html.
  4. Locate misc-command-controller, and select POST /api/site/{sitename}/command/execute. Use these query parameters:
    • sitename:

      smatdb file. For example, This is the name of the site that stores the testmigrate.

    • command:

      This is hcismatcrypt migrate smatdb file path.

      For example:
      hcismatcrypt migrate C:\cloverleaf\cis19.1\integrator\testxlt\case1.smatdb smatdb password

      password is the password for the smatdb file.

    • timeout is the maximum time (ms) for the migration. For example, 50000.
  5. Click Try it out. You should get a "200" response code. This indicates success, and that there is no error, or any other, message in the response.
    Note: You can also send the CLAPI request using the cURL command.