Data Folder Transfer

The Shared Folder Settings tool enables you to automatically transfer a data folder from a specified source location to a destination location, while also updating the SLNXConfiguration file.

Use this command line tool when:

  • You have primary and alternate Core Servers that you want to point to the same storage location.
  • Transferring data due to system upgrades or data reorganization
  • Creating a more efficient storage solution.

The data at the destination location will mirror the source data, ensuring seamless switching between primary and alternate servers.

The tool will:

  • Automatically discover the source data path
  • Stop and start the core service when necessary
  • Control file copying with error handling
  • Delete source data when destination is mirrored
  • Update the configuration file

To execute the tool:

Execute this tool on the Core Server(s) only.

  1. Open a command prompt.

  2. Locate the tool in the Program Files\Ricoh\StreamlineNX\tools\SharedFolderSettingsTool folder.

  3. Run the following command, but replace the required parameters shown in square and angle brackets with the required data outlined in the table below.

    sharedfoldersettingstool.exe [--nocopy] <destination_path>

    Parameter Description
    [--nocopy]

    Optional parameter; use this parameter when adding an alternate Core Server so that the data of the new Core Server does not overwrite the data of the primary Core Server

    This parameter skips the file copying process, updates the configuration file, and set the value of the storage path to the destination path provided.

    The tool validates the destination path before proceeding.

    <destination path>

    Required parameter; specify the destination path where the data storage path will be moved.

    Example: c:\ProgramData\Ricoh\StreamlineNX\DataStoragePath

    If your destination path contains a space, place the full argument in double quotations. For example "c:\ProgramData\Core Data Mirror"

When you enter the command, the tool automatically discovers the location of the data storage path on the Core Server. The tool then validates the existence of the entered destination path. If the path does not exist, you will receive an error message and the process is canceled.

Error logs are available in Ricoh\StreamlineNX\logs\SharedFolderSettings.log.

After the files are copied, the tool validates the data at the destination location to ensure it is an exact mirror of the source. The validation is based on file sizes, timestamps, and checksums to ensure data integrity.

To manually validate the result:

  1. Open the file Program Files\Ricoh\Streamline NX\Configuration\wrapper-settings.conf.

    The set.DATASTORAGEPATH value should show the new storage path that was entered as the destination path.

  2. Verify that the RICOH SLNX Central Manager Service is running.