C.4 Migrating Files

If you have a small number of files to migrate to Kablink Teaming, you can use the migration_uploadFolderFile operation.

However, most Forum installations include a significant number of files, and those files might be large. To improve performance, you should strongly consider using the migration_uploadFolderFileStaged message.

Staging involves moving all of the files from SiteScape Forum to the server running the Kablink Teaming installation. Although the files can be located using any folder hierarchy on the server, a convenient way to migrate files is to unzip the Forum hidden directory onto the Kablink Teaming server machine and to work within that existing folder hierarchy from Forum. After placing the files on the Kablink Teaming server, the migration_uploadFolderFileStaged operation takes files from the staging area and migrates them into the Kablink Teaming installation.

Here are the steps needed to migrate files:

  1. Establish a directory on the Kablink Teaming server machine where you want to place the Forum files.

  2. Make the three required changes to the ssf.properties and ssf-ext.properties files. This action indicates the location of the staging directory. (See the installation guide for more information about the these files.)

    Multiple Forum file versions are separate files in the staged area. Call the migration_uploadFolderFileStaged operation once for each version of the file, using the same filename for each call but specifying a different path. This method creates versioned files in Kablink Teaming.

  3. Copy the Forum files onto the Kablink Teaming server, using the specified staging directory as your top directory.

  4. Use the migration_uploadFolderFileStaged operation to migrate the files into the Kablink Teaming installation.

    This command attaches files to an existing entry. Also, it accepts as one of its arguments a relative path, which traverses the s beneath the designated staging directory.

See migrateFolderFileStaged, for more information.