Moving a Location

This topic describes how to move location L1 files from a machine/path M1/P1 to a new machine path M2/P2.

See Also
FCS Processing
Setting Up the FCS
FCS Bucket Replication
  1. Copy the existing files from M1/P1 to M2/P2, excluding the files created on the current day.

    Do not copy the files of the current day to avoid copying files that may still be under construction.

  2. Install and start a new File Collaboration Server (FCS) on M2. For details, see Installing File Collaboration Server.
  3. Remove location L1 from the site S1 where it is referenced (using the MQL mod site command). The location L1 will no longer be used for checkin/checkout operations. However, it can still be used for file synchronization.

    The central store is used in place of the location. Depending on the latency, S1 users may see a performance impact on file operations.

  4. Force file synchronization from location L1 to store (using the MQL sync store command).
  5. Copy the files created on the current day from M1/P1 to M2/P2.
  6. Update the location L1 definition in order to change the machine/path and FCS URL to the new values.
    From this point on, the new FCS on M2 is ready to be used.
  7. Stop the FCS on M1.
  8. Add location L1 to site S1.
    This makes location L1 used by S1 the site to be used for checkin/checkout operations.
  9. Check that no file has been created on M1/P1 after the last copy.

    This is a verification step in order to double check that all FCS files have been copied to the new machine/directory.

From V6R2013x onwards, tying a location to several stores is no longer supported. This is to enforce per store data isolation and ease admin tasks such as orphan file cleanup. Already existing locations tied to several stores do not need to be migrated but we recommended to do that.

Here is the untie procedure:

  • create a new dedicated location per store tied to the already existing location
  • synchronize each store from the multi-tied location to the new dedicated location
  • once this has been done, purge the multi-tied location.
  • then remove the multi-tied location from each store.