This documentation includes content for releases that might not be available on-premises. For the latest on-premises Asset documentation, see the PDF version of Tanium™ Asset User Guide version 1.26.184.
Integrating with Microsoft Azure Migrate
This integration is currently available as a public preview.
Use assessments in Asset to combine the real-time operational state of your on-premises environment, as known by Tanium, with the robust capabilities of Microsoft Azure Migrate to quantify the economic impact of running workloads in Microsoft Azure without using separate appliances or agents.
Overview
Assessments in Asset provide an automated method to provide Tanium data to your Microsoft Azure Migrate project and run total cost of ownership (TCO) and return on investment (ROI) assessments. You can target an assessment to any segment of your endpoint estate. For example, you might want to assess all on-premises servers that belong to a specific business unit or all servers in a particular geographical region.
For more information about Microsoft Azure Migrate, see Microsoft Azure Migrate documentation: About Azure Migrate.
Before you begin
Before you create an Azure Migrate assessment in Asset, you must complete several prerequisite tasks, as detailed in the following sections:
- Create an Azure account and configure required permissions
- Create an Azure Migrate project
- Create an app registration, Azure client ID, and secret
- Grant the necessary permissions to the service principal for the registered app
- Enable assessments in Asset
- Confirm that the necessary URLs are allowed through your security software
After you complete these tasks, you are ready to Create an assessment in Asset.
Step 1. Create an Azure account and configure required permissions
If you do not have an Azure user account, you must create one to use for the assessment. For an existing user account, confirm that the user account has the required permissions. For details, see Microsoft Azure Migrate documentation: Prepare an Azure user account.
Step 2. Create an Azure Migrate project
If you do not have an Azure Migrate project, you must create one to use for the assessment. For details, see Microsoft Azure Migrate documentation: Create a project for the first time.
If you are using an existing Azure Migrate project, confirm that the Azure Migrate: Discovery and assessment tool is available in the project. If you did not create the project from the Discover, assess and migrate option on the Azure Migrate Get Started page, you must add this tool to the project. For details, see Microsoft Azure Migrate documentation: Select a discovery and assessment tool.
Note the following details about the project so that you can provide them when you create the assessment in Asset:
- Name of the project
- Subscription UUID for the subscription in which you create the project. For steps to find your subscription ID, see Microsoft Azure documentation: Find your Azure subscription.
- Resource group that you selected or created for the project
Step 3: Create an app registration, Azure client ID, and secret
In the Microsoft Azure portal, create an app registration and then create an Azure client ID and secret for that app to use for authentication.
Register an application
For detailed steps, see Microsoft Azure documentation: Quickstart: Register an application. You do not need to configure the optional Redirect URI.
When you save the registration, note the Application (client) ID to use when you create the assessment.
Add a client secret
For detailed steps, see Microsoft Azure documentation: Quickstart: Add a client secret
After you add the client secret, record the Value for the client secret and save it to a secure location. You cannot see this value again after you leave this page.
You do not need to complete the other sections in the article.
Step 4: Grant the necessary permissions to the service principal for the registered app
Microsoft Azure automatically creates a service principal object when you register an app (which you completed in Step 3). This service principal object must have Contributor or Owner roles on the associated Azure subscription for the assessment to complete successfully. For detailed steps, see Microsoft Azure documentation: Assign Azure roles using the Azure portal.
- In Step 3 of the article, select the Privileged administrator roles tab to see the Contributor or Owner roles.
- In Step 4 of the article, select the service principal that was created for your registered app.
Step 5: Enable assessments in Asset
Enable the assessments feature
Add a Tanium Core Platform advanced setting to add the assessments feature to Asset. For more information about Tanium Core Platform settings, see Tanium Console User Guide: Managing Tanium Core Platform settings.
- From the Main menu, go to Administration > Configuration > Settings > Advanced Settings.
- Click Add Setting, configure the following properties, and click Save:
- Setting Type: Select Server.
- Name: Enter console_enable_asset_assessments.
- Value Type: Select Numeric.
- Value: Enter 1.
Enable assessments in the Asset settings
- From the Asset Overview page, click Settings
.
- On the Advanced tab, select to enable Assessments.
- Click Save.
Step 6: Confirm that the necessary URLs are allowed through your security software
If security software is deployed in your environment to monitor and block unknown URLs, your security administrator must allow the following URLs:
- discoverysrvprodcusrepsa.blob.core.windows.net
- management.azure.com
- login.microsoftonline.com
Create an assessment in Asset
- From the Asset menu, click Assessments.
- Create the assessment:
- To create a new assessment, click Create Assessment > Azure Migrate.
- To create an assessment based on an existing assessment, click Copy
in the row for the assessment that you want to use as the base configuration.
- Specify a Name and optional Description for the assessment.
- (Optional) Set the Log Level.
The default log level (Information) is sufficient for typical usage. Adjust the log level only when you are troubleshooting an issue.
- In the Azure Connection Details section, provide these details:
- Directory (tenant) ID: Enter your Entra ID tenant ID.
For steps to find your tenant ID, see Microsoft Azure documentation: Find your Azure AD tenant.
- Application (client) ID: Enter the Azure Application (client) ID for the application that you created and registered with the Microsoft identity platform in the "Before you begin" section.
- Client Secret: Provide the Value for the client secret that you generated for the application that you created and registered with the Microsoft identity platform in the "Before you begin" section.
- Click Verify Connection to confirm that the connection is valid.
Ensure that you receive a Connection successful message before you proceed to the next section. If the verification fails, see Troubleshoot Microsoft Azure assessments.
- Directory (tenant) ID: Enter your Entra ID tenant ID.
- In the Azure Project Details section, provide these details:
- Subscription ID: Enter the UUID for the subscription in which you created the Azure Migrate project.
For steps to find your subscription ID, see Microsoft Azure documentation: Find your Azure subscription.
- Resource Group Name: Enter the resource group that you selected or created when you created the Azure Migrate project.
- Azure Migration Project Name: Enter the name of the Azure Migrate project that you created to use for the assessment.
- Azure Location: Select the Azure location to use for the assessment.
This location must match the location for your resource group. If you did not record the location when you created the project in the "Before you begin" section, you can find it in the Essentials for the resource group. In the Azure Portal, search for the Resource groups service. Open the Resource groups service and then click the name of your resource group.
- Subscription ID: Enter the UUID for the subscription in which you created the Azure Migrate project.
- In the Targeting section, click Select Computer Groups. Select the computer groups to target with this assessment and click Save.
- In the Configuration section, provide these details:
- Azure Offer Code: Enter the Azure offer code to use for the assessment.
For a description of the current Microsoft Azure offers, see Microsoft: Microsoft Azure Offer Details.
- Savings Options: If you plan to use Azure Reserved Instances (RI), select the savings plan you want to use for the assessment. Select None if you do not plan to use Azure Reserved Instances.
For more information about Reserved Instances, see Microsoft Azure: Azure Reserved Virtual Machine Instances.
- (Optional) Discount Percentage: If you selected None for Savings Options and have a discount offer to apply in addition to the Azure offer code, specify the discount percentage to apply on the final price in the assessment. Valid values are numbers from 0 - 100.
- Sizing Criteria: Select the sizing criteria to use for the assessment.
For more information about sizing criteria, see Microsoft Azure Migrate documentation: Azure VM Assessment overview.
- Azure Offer Code: Enter the Azure offer code to use for the assessment.
- Click Submit to save your changes.
The assessment is available on the Assessments page in Asset. The status is Ready to Run until it runs for the first time. To run the assessment, click Run
.
Depending on the number of targeted endpoints, an assessment can take several hours to complete.
Work with assessments
After you create an assessment, run the assessment from the Assessments page in Asset to generate the assessment results in Azure Migrate. Assessments in Asset can have the following states:
Status | Description |
---|---|
Ready to Run | The assessment is configured and ready to run. Click Run |
In Progress | The assessment is in progress. |
Completed | The assessment is complete and ready to open in Azure Migrate. Click the link for the assessment on the Assessments page in Asset to open the resulting report in Microsoft Azure Migrate. |
Canceled | The assessment was canceled while in progress. |
Failed | The assessment failed to complete. Edit the assessment and confirm that all details are correct before you attempt to run the assessment again. For more information about troubleshooting, see Troubleshoot Microsoft Azure assessments. |
Run an assessment
- From the Asset menu, click Assessments.
- In the row for the assessment, click Run
.
Depending on the number of targeted endpoints, an assessment can take several hours to complete.
Edit an assessment
- From the Asset menu, click Assessments.
- In the row for the assessment, click Edit
.
- Make the necessary changes and click Save. Run the assessment again to use the updated details in the assessment results.
Open a completed assessment
- From the Asset menu, click Assessments.
- Click the name of the assessment to open the assessment results.
- (Optional) On the assessment page, click View Assessment Details to open the assessment in Microsoft Azure Migrate or View Business Case to open the business case in Microsoft Azure Migrate.
For more information about interpreting the assessment results, see Microsoft Azure Migrate documentation: Review an assessment. For more information about business case reports, see Microsoft Azure Migrate documentation: Overview report.
Delete an assessment
- From the Asset menu, click Assessments.
- In the row for the assessment, click Delete
.
Last updated: 9/22/2023 9:47 AM | Feedback