GetSocial Migrator is a command-line tool 🖥️ designed to migrate your groups, users, comments, and reactions data from the GetSocial system to Amity Social Cloud (ASC). This powerful tool makes the transition smoother and easier.
Kickstart the migration process by cloning this repository. Once done, install the required dependencies using the following command:
npm iLaunch the migrator tool by using the below command:
npm run startThe tool will then prompt you for the necessary details to facilitate migration:
App ID: App ID of GetSocial.API Key: API Key of GetSocial.Auth Identity: The identifier key used to identify the user identity in GetSocial (such as 'email'). This is used to migrate users from theuser.authIdentitiesobject in GetSocial. For example, if Auth Identity is set toemail, the migrator tool will identify GetSocial users based on the value inuser.authIdentities.email. Users with the same value will be recognized as the same user and will not be migrated twice.Amity Social Cloud Region: The region of the Amity Social Cloud system where your app is located.Amity Social Cloud API Key: Your API key for the Amity Social Cloud system.Amity Social Cloud Admin Token: Your Admin Token for the Amity Social Cloud system.
Once all these details are filled in, the system will prompt you to select the group you wish to migrate. Upon selection, it will be created as a Community in Amity Social Cloud with its associated members, posts, comments, and reactions.
The GetSocial Migrator tool operates under certain specifications and limitations that are crucial to understand:
- Users Migration: The migration tool operates on a group-by-group basis. Consequently, users who aren't associated with any group cannot be migrated.
- Approved Entities: Only approved members and posts are migrated.
- Unsupported Entities: Topic and poll posts aren't supported.
- Partial Migration: Action buttons and mention data from GetSocial aren't migrated.
- Unsupported Reactions: Reactions on comments aren't supported.
- Unsupported Comments: Multi-level comment replies using
targetand admin comments aren't migrated. - Followers Migration: Followers are migrated along with all follow relationships of any group members being migrated.
- Follow Relation Group: Follow relation group (users who follow group instead of joining group) is not migrated.
- Labels to Tags: Labels from GetSocial are converted to tags in ASC.
- Auth Identities Migration: The
authIdentitiesof GetSocial users are migrated to metadata in ASC. - User Properties: User's public and private properties are migrated and merged into User's
metadataobject. - Activities Properties Migration: GetSocial activities' properties are transferred into the metadata of the corresponding object (post, comment) in ASC.
- Uploaded Avatars Migration: User profile avatars uploaded to GetSocial are migrated and reuploaded to ASC.
- External Avatars: User profile avatars using external links are moved to
customAvatarUrlin ASC, but the image files aren't migrated to ASC.
- Supported Types: Text, image, and video posts/comments are supported.
- Video-Image Posts: Posts with both video and image are converted into videos only, with images dropped from the migration.
- Media Files Migration: All images and videos in posts and comments are migrated and reuploaded to ASC.
- Admin Posts Migration: Posts and comments created by the GetSocial admin are migrated as created by the Admin that owns the ASC Admin token.
- The system is idempotent, ensuring that groups, users, posts, comments, and reactions that have already been migrated won't be re-migrated. This makes it safe to re-run the migrator without causing duplication.
Debug logs are maintained in the output.log file, and any errors are tracked in the error.log file. These files should be regularly checked to get detailed information about each migration process and to troubleshoot errors.