#Prerequisites

This section details prerequisites and steps for moving from legacy tyGraph to AvePoint tyGraph.

#Security Review

With AvePoint tyGraph, permissions are similar to those you have already approved in your environment for legacy tyGraph. Depending on when you signed up for legacy tyGraph, some new permissions have been added to support reports such as Copilot Adoption and Sites that I Own. You can let AvePoint create an app in Microsoft Entra ID automatically or bring your own app registration if you need to customize the permission set.

See Automate App Creation in Microsoft Entra ID for more information on how to automatically create apps in Microsoft Entra ID.

*Note: Some reports may not show data if permissions are removed.

Most organizations will want to conduct a new security review, so we recommend starting that process early to ensure it is completed before you are ready to upgrade.

#Permissions Required

Refer to API Permissions required by tyGraph to see the API permissions that should be accepted when you give consent to the corresponding apps.

#Permission Comparison Between Legacy tyGraph and AvePoint tyGraph

The table below lists the differences in permissions between legacy tyGraph and AvePoint tyGraph.

Permissions	Claim	Permission type	tyGraph for Viva Engage	tyGraph for SharePoint	tyGraph Enterprise	AvePoint tyGraph
Microsoft Graph	Directory.Read.All	Delegated	Yes	Yes	Yes	No
Microsoft Graph	Sites.Read.All	Delegated	No	Yes	No	No
Microsoft Graph	User.Read	Delegated	Yes	No	Yes	Yes
Microsoft Graph	Group.Read.All	Application	No	No	Yes	Yes
Microsoft Graph	GroupMember.Read.All	Application	No	No	No	Yes
Microsoft Graph	Sites.Read.All	Application	No	Yes	Yes	Yes
Microsoft Graph	CallRecords.Read.All	Application	No	No	Yes	Yes
Microsoft Graph	Directory.Read.All	Application	Yes	Yes	Yes	Yes
Microsoft Graph	User.Read.All	Application	Yes	Yes	Yes	Yes
Microsoft Graph	Files.Read.All	Application	No	Yes	Yes	Yes
Microsoft Graph	ChannelMember.Read.All	Application	No	No	No	Yes
Microsoft Graph	ChannelMessage.Read.All	Application	No	No	Yes	Yes
Microsoft Graph	Reports.Read.All	Application	Yes	Yes	Yes	Yes
Microsoft Graph	Channel.ReadBasic.All	Application	No	No	No	Yes
Microsoft Graph	Team.ReadBasic.All	Application	No	No	No	Yes
Microsoft Graph	TeamsTab.Read.All	Application	No	No	No	Yes
Office 365	ActivityFeed.Read	Application	Yes	Yes	Yes	Yes
Management APIs	ActivityFeed.Read	Application	Yes	Yes	Yes	Yes
Office 365	Sites.Read.All	Application	No	No	Yes	Yes
SharePoint Online	Sites.Read.All	Application	No	No	Yes	Yes
Office 365	AllSites.FullControl	Delegated	No	Yes	No	No
SharePoint Online	AllSites.FullControl	Delegated	No	Yes	No	No
Office 365	Sites.FullControl.All	Application	No	Yes	No	Yes
SharePoint Online	Sites.FullControl.All	Application	No	Yes	No	Yes
Viva Engage	access_as_user	Delegated	No	No	No	Yes
Viva Engage	User_impersonation	Delegated	No	No	No	Yes

#Customizations Assessment

Some legacy tyGraph users have implemented customizations in the data model, ETL, or reports. These reports may delay or block users from upgrading until AvePoint has migrated them. We are implementing new features to support the most common user customizations, which will make the upgrade experience smoother. For SaaS users, we have already assessed the customizations in your environment.

If we identify customizations in your environment, we may give you the option to:

Your account team will discuss any customizations identified in your environment and discuss the options with you to ensure the best upgrade timeline for you.

For self-hosted users opting to migrate to AvePoint tyGraph SaaS, we will provide you with a script that you can run in your environment to identify customizations. We will review the output and discuss how this will affect your migration.

#Upgrade Windows

AvePoint will be upgrading users from legacy tyGraph to AvePoint tyGraph throughout a series of windows through the end of 2024 and 2025. AvePoint will work with you to select an upgrade window based upon:

Your AvePoint account team will work with you to find an upgrade window that works for you. As a user, you must have completed your internal Security Review, have a license granted by AvePoint, and grant consent for AvePoint tyGraph to collect your data before you can be migrated in a window. If these steps have not been completed, you will be moved to a later upgrade window.

For more information on granting consent for AvePoint tyGraph, refer to Create an App Profile.

The upgrade windows take two weeks. Your upgrade will take less than a day and will occur sometime during that two-week window. You can continue to use your existing legacy tyGraph environment throughout the upgrade period. After the upgrade, your legacy environment and upgraded environment will be available during a Validation Period. You can use this period to validate that the data in the new environment looks correct.

#Data Privacy

Refer to Data Privacy for more details on data privacy settings.

#Install the New tyGraph Pages Engine

After you have received your AvePoint tyGraph license and before your upgrade occurs, you need to install a new version of the tyGraph Pages Engine. Until your Validation Period is complete, you will keep the legacy version of tyGraph Pages Engine installed along with the new version. This allows for data to be collected in both environments ensuring a smooth transition experience.

#Install the New tyGraph Pages Engine

You can find the instructions on installing the new tyGraph Pages Engine in the tyGraph Pages Web Part Installation section.

*Note: Installing the new tyGraph Pages Engine will not affect your existing reports in any way.

#Identify tyGraph Pages Engine Versions

Once you have installed the new tyGraph Pages Engine into your App catalog, your installed apps will look like the screenshot below:

The legacy version of the tyGraph Pages Engine will show an app version number starting with 1.7.0.x. The new AvePoint tyGraph Pages Engine will show an app version number starting with 2.1.0.x.

#tyGraph Pages Web Parts

Wait for a notification that your upgrade is finished before installing the new package. Installing the new web parts package early will result in multiple Site Analytics web parts displaying in the web part picker and duplicate report bars.

#Remove Legacy tyGraph Pages Engine

When you have completed your Validation Period, you may remove the legacy tyGraph Pages Engine. Remove the package with a version number starting with 1.7.0.x. Keep the tyGraph Pages Engine with version 2.1.0.x. Once the legacy tyGraph Pages Engine is removed, telemetry will no longer be sent to your legacy environment.