Delen via


Upgrade the Microsoft Purview Information Protection scanner

Use the following instructions to upgrade the information protection scanner to the latest version from the Microsoft Purview Information Protection client:

For the latest release information and support timelines for each version, see Microsoft Purview Information Protection client - Release management and supportability.

Upgrade the scanner from the Azure Information Protection client (version 2.x)

Important

Upgrading the Microsoft Purview Information Protection scanner from client version 2.x to version 3.x requires additional and specific steps because service names and other components are renamed.

To avoid misconfigurations that can result in the scanner no longer working, make sure you follow each step that follows.

  1. On any scanner node in the cluster, run the following command and make a note of the SQL database name and cluster:

    Get-AIPScannerConfiguration
    
  2. Get ready to install the new version of the scanner on each node in the cluster by stopping the scanner service:

    Net Stop AIPScanner
    
  3. Uninstall the existing scanner service:

    Uninstall-AIPScanner
    
  4. Restart the Windows server computer to completely remove the service.

  5. Uninstall version 2.x of the Azure Information Protection unified labeling client.

  6. Install version 3.x of the Microsoft Purview Information Protection client

  7. Install the scanner from the information protection client:

    Install-Scanner -SqlServerInstance  <SQL\InstanceName>  -Cluster <cluster-name>
    

    For example, to upgrade the scanner that uses the SQL Server instance named SCANNER that runs on the server named SQLSERVER1 and uses the cluster name of EU as the database for the scanner configuration:

    Install-Scanner -SqlServerInstance SQLSERVER1\SCANNER -Cluster EU
    

    For more details and other examples that include using the SQL Server default instance and SQL Server Express, see the examples from Install-Scanner.

  8. Stop the scanner service:

    Net Stop MIPScanner 
    
  9. Update the scanner database: On one scanner node, run the following command:

    Update-ScannerDatabase
    
  10. Start the scanner service on the Windows server computer.

  11. For each node in the cluster, start the scanner service:

    Net Start MIPScanner
    

The scanner is now upgraded for the Microsoft Purview Information Protection client and ready to resume any scanning jobs that are configured.

Upgrade a previous version of the scanner from the information protection client (version 3.x)

Use the following instructions to upgrade the scanner from an earlier version from the Microsoft Purview Information Protection client (version 3.x).

For example, you're upgrading from a preview version of the Microsoft Purview Information Protection client to a general availability (GA) version. Or, you're upgrading from a GA version of the Microsoft Purview Information Protection client to the latest version of this client.

  1. Get ready to install the new version of the scanner on each node in the cluster by stopping the scanner service:

    Net Stop MIPScanner
    
  2. Install the latest version of the Microsoft Purview Information Protection client.

  3. Update the scanner database: On one scanner node, run the following command:

    Update-ScannerDatabase
    
  4. Start the scanner service on the Windows server computer.

  5. For each node in the cluster, start the scanner service:

    Net Start MIPScanner
    

The scanner is now upgraded to the latest version from the Microsoft Purview Information Protection client and ready to resume any scanning jobs that are configured.