User Migration utility

The naming schema for user names has changed. Therefore, after upgrading, you will need to download the User Migration utility from the BriefCam Downloads page. If the utility is not available on the download page, contact the BriefCam Support team.

Download the User Migration utility to the computer running the BriefCam server, place it in the BriefCam server directory, and run it from there.

For more information about the User Migration utility for XProtect Rapid REVIEW and what it implies to migrate users see the article about user migration on the Milestone Support Community page.

To run the utility

  1. Export the existing users by running the following command.

    UserMigrationUtility.exe -m export

    The command needs to be run by the user that is used to run the BriefCam.

    This will produce a csv file in the current directory under a subdirectory named “csv” with the following format: [existing user name],[existing user name].

    For example:

    userA,userA

    userB,userB

    userC,userC

  2. Modify the generated csv file so that the second argument in every row is the user name in the new format. You’ll use the following guidelines for the new naming convention:
    User type and name in the Milestone Smart ClientUser created in BriefCam by the Milestone SSO Provider
     Original NameName After the Upgrade
    Basic user “Steve”Steve[BASIC]\Steve
    Local user “Steve” running on a Windows host named “MACHINE”Steve[MACHINE]\Steve
    Domain user “Steve” running in a domain called “DOMAIN”Steve

    [DOMAIN]\Steve

     

    Milestone user named "Administrator"Administrator[BASIC]\Administrator or <machine>\Administrator or <domain>\Administrator (depending on the user type)

    For example, if userA is a basic user, userB is a local user running on a machine named "Windows1", and userC is a Domain user in domain "Domain1", the migration csv file should contain these rows:

    userA,[BASIC]\userA

    userB,Windows1\userB

    userC,Domain1\userC

  3. In the directory where the tool is saved, create a subdirectory named Migrate, and place the modified csv file in the new Migrate subdirectory.

  4. Migrate the user names by running the following command:

    UserMigrationUtility.exe -m migrate

Not all the users need to be migrated. It is possible to migrate only some of the users.

Only BriefCam basic users can be migrated using the utility. BriefCam administrator accounts cannot be migrated.

If the source and target user names are the same, the user will be skipped and will not be migrated.

If the target user already exists in BriefCam, all assets belonging to the source user will be transferred to the target user.