Viva Engage (Yammer) Tenant to Tenant Migration Guide

Establish a connection with the Source Connector Account by signing in through the Apps4.Pro Migration Manager app.

Steps to Connect:

1. Go to the Setup tab in the Migration App.
2. Under Source Connection, click on the Copy & Open button.
3. Paste the copied code into the authentication window.
4. Enter the Source Connector Account details to complete the connection.

Establish a connection with the Target Connector Account by signing in through the Apps4.Pro Migration Manager app.

Note: For Migration across Data Centers (Geo-Switch), ensure the Target Connector is the re-provisioned Tenant in the Target Geo.

Steps to Connect:

1. Go to the Setup tab in the Migration App.
2. Under Target Connection, click on the Copy & Open button.
3. Paste the copied code into the authentication window.
4. Enter the Target Connector Account details to complete the connection.

Once you configure the Target Viva Engage (Yammer) Connection, follow the below steps.

1. Sign-in to the Viva Engage (Yammer) Client Applications page (https://www.yammer.com/client_applications) with your Target Connector Account.
2. Once logged in, click on ‘Register New App’.
3. Refer below table fill all the required fields and then click Continue.
   
4. Copy the Client ID of the app.
5. Go to Apps4.Pro Migration manager and click on the key button which is beside the Target Viva Engage (Yammer) Connection.
6. Paste the Client ID on the text box and save the settings.

The migration scoped users in the Source and target tenants need to be mapped so the app can utilize this information to add membership during migration.

Steps to Perform User Mapping:

Navigate to the “Mapping” tab → USERS MAPPING. Here, you can add user mappings based on any of the options listed below.

Option 1 – Individual Manual Mapping: Manually add user mappings using the “Add” option.

Option 2 – Bulk Mapping through Auto Map: If user’s display name or UPN in the Source and target tenants are the same, our tool provides an “Automap” feature to streamline the mapping process.

Option 3 – Upload bulk mappings through CSV: If the display names of the users in the Source and target tenants are different, you can download the sample file, add the user mappings, and import them using the “Import CSV” option.

You can download the tenant-level users to frame the Mapping CSV, please refer to Application Tenant Data Refresh.

Sample CSV File

To migrate a Private group, Source Connector Account should be member of that Private group. Follow the below mentioned steps.

1. Go to Plan Tab → Reports → Under Yammer, select “Source Network Groups” report.
2. Select the Network(s) to list all the groups inside the selected network(s).
3. Now filter the Group Privacy column as “private” and IsMemberGroup column as “false”
4. You can see the private groups where the Source Connector is not a member.
5. Select the groups and click on Manage Members and Owners. Then add the Source Connector as a member by clicking on the (+) option and update.

Apps4.Pro uses Yammer Import-Export features to “Port Viva Engage (Yammer) Networks across Data Centers (Geo-Switch)”. To enable Delta Migration for such cases, follow the below mentioned steps.

Navigate to Settings -> Other settings -> Migration Settings -> Yammer Settings

1. Setting 1 :  Disable setting “Yammer Group Migration with API (Recommended)”
2. Setting 2 : Enable setting “Yammer Export Delta Migration”

User Impersonation is the process in which Posts are posted by the users themselves in the target. Please consider the below with regards to User Impersonation.

• BY DEFAULT, Apps4.Pro follows User Impersonation and hence Posts are posted by the users themselves in the target.
• If any of the user has skipped the pre-requisite #1(Users should login to Viva Engage (Yammer) portal in target tenant with their Accounts at least once before the migration starts), active user profile will not be found in the target and hence the migration job cannot proceed. To avoid this,
  • Navigate to Settings -> Other settings -> Migration Settings -> Yammer Settings.
  • Enable the option ‘Skip User Impersonation if active Yammer User Profile not found in Target Tenant’.
• If you like to migrate the post for unmapped users, then you can proceed enabling the below setting.
• Navigate to Settings -> Other settings -> Migration Settings -> Yammer Settings.
• Enable the option ‘Skip User Impersonation if mapping/membership failure.

Note: If you enable any of the above setting, ‘User Impersonation’ is skipped and the posts will be posted by the Service Account instead.

Skipping User Impersonation will look like this :

Source

Target

Apps4.Pro provides the choice to migrate only the files attached to message or the files part of the associated SharePoint Site.

Navigate to Settings -> Other settings -> Migration Settings -> Yammer Settings

1. Make sure the Setting “Yammer Group Migration with API(Recommended)” is enabled.
2. Choose one of the below options as required
   • Choice 1 : “Migrate only message attachment files”
   • Choice 2 : “Migrate all group files” : Migrates the Files & Folders part of the Group associated SharePoint Site’s Default Document Library.

Step 1 : Create Job

1. Navigate to Migrate tab
2. Enter a Job Name
3. Select Source as Yammer
4. Select the Networks to Migrate
5. Select “Yammer Migration”
6. Click Next

Step 2 : Target Settings

Network Settings

In this step, you can provide the target network(s) to migrate data. Here,

• You can map a Source Network with a Network in Target.
• You can also cross-map – Map an Internal Network with an External Network and vice versa.

Group Settings

In this step, you can provide the target group(s). You have following options to select target groups.

• Migrate into a new group.
• Migrate into an existing group.

Step 3 : Job Summary

In this step, you can view the summary of job. After checking the summary, you can select one of the following two options.

• Save Job -> It saves the current job, then you can run later by clicking Start button from Migration Jobs grid.
• Save & Migrate Job -> It saves the current job and starts the migration process immediately.

Step 4 : Execute Saved Jobs

Under Migration Jobs section – the Jobs and their summary are listed. You can opt to run the previously saved jobs by clicking the Start button under Action column.

You can also find the progress of the Jobs and their summaries here.

This approach supports migration between data centers (Geo-Switch) by using the Export & Import options. The porting of data across Data Centers is done in 2 stages.

Stage 1 : Yammer Export

Important: Do remember to perform this step before the cut over of the Source Data Centre.

1. Navigate to Migrate tab
2. Enter a Job Name
3. Select Source as Yammer
4. Select the Networks to Migrate
5. Select Yammer Export
6. Click Next

Delta Migration :

If you would like to export only the data for a certain period instead of the entire data, you can perform Delta Migration by following the below steps

• Make sure the settings mentioned in Delta Migration for Geo-Switch is enabled
• Enable Delta Migration
• Mention the Start Date and Due Date

Now, Viva Engage (Yammer) data from Source Tenant is exported and stored in your local machine.

Note: You can find the progress of the Job Under “Migration Jobs” section – the Jobs and their summaries are listed.

Stage 2 : Yammer Import

Important: Perform this step post completion of the re-provision of Viva Engage (Yammer) Network in Target Data Centre.

Step 1 : Create Job

1. Navigate to Migrate tab
2. Enter a Job Name
3. Select Source as Yammer
4. Choose Yammer Import
5. Select the Exported Networks to Migrate
6. Click Next

Step 2 : Target Settings

Network Settings

In this step, you can provide the target network(s) to migrate data. Here,

• You can map a Source Network with a Network in Target.
• You can also cross-map – Map an Internal Network with an External Network and vice versa.

Group Settings

In this step, you can provide the target group(s). You have following options to select target groups.

• Migrate into a new group.
• Migrate into an existing group.

Step 3 : Job Summary

In this step, you can view the summary of job. After checking the summary, you can select one of the following two options.

• Save Job -> It saves the current job, then you can run later by clicking Start button from Migration Jobs grid.
• Save & Migrate Job -> It saves the current job and starts the migration process immediately.

Step 4 : Execute Saved Jobs

Under Migration Jobs section – the Jobs and their summary are listed. You can opt to run the previously saved jobs by clicking the Start button under Action column.

You can also find the progress of the Jobs and their summaries here.

Once the Job is complete, the offline downloaded data (via export) is transferred to the tenant in the Target Data Center.

Please follow the steps below to create a Transport rule from Exchange

Step 1: Open the Exchange Admin Center using this URL  https://admin.exchange.microsoft.com.

From the Left Menu Pane, click Mail flow -> Rules, then click the + Add a rule action to create a new rule. 

Step 2 : Fill the highlighted fields to Set rule conditions. 

• Name – Type the name of the rule 
• Apply this rule if

Click the Edit icon and add the email address notifications@yammer.com (and also notifications@eu.yammer.com if your tenant is located in the European region) to block the assignee notifications. 

• Do the following 

Click the Edit icon and enter a sentence such as “Blocked notification during Yammer Migration” to learn why this message was prohibited.

Step 3 : Click Next 

Step 4 : Set the Rule settings , select Rule mode as Enforce and click Next 

Step 5: Now review the rule and click Finish  

Step 6: The created rule is disabled by default, therefore to enable it, open it and enable the toggle button, then wait until the Status changes to Enabled.