> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> These are instructions for an in-place upgrade to the latest version of the TruU CA Adapter, 26.1. This version supports upgrades for all previous versions.

## Prerequisites

1. **.NET**: Requires .NET 4.8 or higher.

Download the .NET Framework offline installer runtime from here: [Download .NET Framework 4.8 | .NET](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48)

<Warning>
  Before upgrading, please verify the .NET version running on your current CA Adapter server. You can use the following command in elevated PowerShell to check your current .net version:

  PowerShell

  ```
  Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" | Select-Object -Property Release, Version
  ```
</Warning>

2. **CA Adapter Service Account:** Username and Password

## **Downloading the latest CA Adapter installer**

1. Logon to your CA Adapter Server.
2. Log in to the TruU Admin Console.
3. Navigate to Profile Menu → Downloads.

<img src="https://mintcdn.com/truu-2/rjjBxA7Z_Wk_-34G/images/docs/ef51c65dbaaa799693cd991420f82e343c8d9f03405baf1ecbbf0a69d3e4a0b6-image.png?fit=max&auto=format&n=rjjBxA7Z_Wk_-34G&q=85&s=867f3af1154ab7661226fc19d08a15e7" alt="" width="991" height="257" data-path="images/docs/ef51c65dbaaa799693cd991420f82e343c8d9f03405baf1ecbbf0a69d3e4a0b6-image.png" />

4. Accept the EULA.

<img src="https://mintcdn.com/truu-2/rjjBxA7Z_Wk_-34G/images/docs/f4e370f122cd2abbb30959f6823535512843805048a585ca79b881fc50e9bc1c-image.png?fit=max&auto=format&n=rjjBxA7Z_Wk_-34G&q=85&s=56db8c229089128269b7ba4927e75cdb" alt="" width="984" height="525" data-path="images/docs/f4e370f122cd2abbb30959f6823535512843805048a585ca79b881fc50e9bc1c-image.png" />

5. Click on the *TruU Active Directory Certificate Authority Adapter*. This will download a .zip file

<img src="https://mintcdn.com/truu-2/YlfY4z_3_-uDkBaP/images/docs/5e7f3d520c4dcd512398260ae5cb88dae8a2a1f7b70b346d158f8c4cb208d78b-image.png?fit=max&auto=format&n=YlfY4z_3_-uDkBaP&q=85&s=7fa18f51d427eea39a1fd22ba41022ef" alt="" width="726" height="456" data-path="images/docs/5e7f3d520c4dcd512398260ae5cb88dae8a2a1f7b70b346d158f8c4cb208d78b-image.png" />

6. Extract the ZIP file and Double-click the *TruuCaAdapterInstaller\_26\_1.msi*

<img src="https://mintcdn.com/truu-2/L38yxuvvUa8uAW5I/images/docs/1a5c751cdf84d90806d3528dbef506770461db05986b2fbfdf9b28bfec97d9d1-image.png?fit=max&auto=format&n=L38yxuvvUa8uAW5I&q=85&s=94a060848b5b697706050798da357e7c" alt="" width="800" height="225" data-path="images/docs/1a5c751cdf84d90806d3528dbef506770461db05986b2fbfdf9b28bfec97d9d1-image.png" />

7. Once the Installer launches, Click **Next**.

<img src="https://mintcdn.com/truu-2/jMF4bYA9yOA_2TKv/images/docs/2fb34e3ba828a6c81e8357c6828b23c02b02ba9aedebc15e139580f70584c90e-image.png?fit=max&auto=format&n=jMF4bYA9yOA_2TKv&q=85&s=8d440682f1c42ca448c4f6c554fb8dfb" alt="" width="1231" height="964" data-path="images/docs/2fb34e3ba828a6c81e8357c6828b23c02b02ba9aedebc15e139580f70584c90e-image.png" />

8. Review and accept the License Agreement, then click **Next** to continue.

<img src="https://mintcdn.com/truu-2/E6hYbyLPrBHWbQ3m/images/docs/d4546385badd0aa369e4bcb4b53b7de1ef1f9b99fff890fce550b98b25e3192a-image.png?fit=max&auto=format&n=E6hYbyLPrBHWbQ3m&q=85&s=d18674a541e103ee2cac1d18d4e598f9" alt="" width="1222" height="953" data-path="images/docs/d4546385badd0aa369e4bcb4b53b7de1ef1f9b99fff890fce550b98b25e3192a-image.png" />

9. The existing TruU adapter configuration will already have the following information populated

<img src="https://mintcdn.com/truu-2/E6hYbyLPrBHWbQ3m/images/docs/be04f80f28e3f6c77504a5e2e9508939ff33c601138bb29b42de473710be3c60-image.png?fit=max&auto=format&n=E6hYbyLPrBHWbQ3m&q=85&s=ce13c7ef1cba9b62c093d945415df8ae" alt="" width="504" height="456" data-path="images/docs/be04f80f28e3f6c77504a5e2e9508939ff33c601138bb29b42de473710be3c60-image.png" />

<Warning>
  If you close the wizard, the above information will be removed. In such case, you will need the previous CA Adapter Configuration TXT file. \**If you can not locate your previous CA Adapter Configuration TXT file, you would need to create a new adapter in the Admin Console*

  After you locate the TXT file:

  * Add the **Identity Server URL** (Identity Server load-balancer URL), **Adapter Key** and **Adapter Secret**
  * For **Log On Account** and **Log On Password**, enter the service account username and password as shown in the image.
  * Once entered, click **Next** to continue.  

      <img src="https://mintcdn.com/truu-2/m22YLP0oXSNG0U3O/images/docs/87bcbc3283ce0de484dcfaf4207155bcc347c1ab1b47fbf5b7c70dabdab6370f-image.png?fit=max&auto=format&n=m22YLP0oXSNG0U3O&q=85&s=0be23dfaa8cd7375a7d41d0a416c26bd" alt="" width="1149" height="503" data-path="images/docs/87bcbc3283ce0de484dcfaf4207155bcc347c1ab1b47fbf5b7c70dabdab6370f-image.png" />
</Warning>

10. Confirm the CA Adapter’s installation path, then click **Next** to continue.

<img src="https://mintcdn.com/truu-2/jMF4bYA9yOA_2TKv/images/docs/391eacdc7312f066da3416ff337ffef65493a9ca103df72971d302392d5efa7e-image.png?fit=max&auto=format&n=jMF4bYA9yOA_2TKv&q=85&s=fee2b3015276a7ff1926a79c2351ee8f" alt="" width="491" height="385" data-path="images/docs/391eacdc7312f066da3416ff337ffef65493a9ca103df72971d302392d5efa7e-image.png" />

11. Click **Install** to initiate the installation.

<img src="https://mintcdn.com/truu-2/jMF4bYA9yOA_2TKv/images/docs/26d433953c99d367b25742a27f89948491c82ea45d9084057dfe5972b9f6eab1-image.png?fit=max&auto=format&n=jMF4bYA9yOA_2TKv&q=85&s=d0fe5dc6ac2a7b44262e1ec202981367" alt="" width="492" height="384" data-path="images/docs/26d433953c99d367b25742a27f89948491c82ea45d9084057dfe5972b9f6eab1-image.png" />

12. Click **Finish** once to complete installation and close installer window. 

<img src="https://mintcdn.com/truu-2/E6hYbyLPrBHWbQ3m/images/docs/cf9ba78e400983336994fff2d881cd8952ef574f9d7243740fbdf3ccb2dbe94f-image.png?fit=max&auto=format&n=E6hYbyLPrBHWbQ3m&q=85&s=2d72035cd0216a132d5aa9a463a194b3" alt="" width="492" height="385" data-path="images/docs/cf9ba78e400983336994fff2d881cd8952ef574f9d7243740fbdf3ccb2dbe94f-image.png" />

13. In your TruU Admin Console, Go to**Integrations** > Adapters to confirm that the updated adapter is**Healthy**.

<img src="https://mintcdn.com/truu-2/jMF4bYA9yOA_2TKv/images/docs/288d6cef5253d83ea06afdd629c8b3f2a0221aa1f689da46f4849c504db8aacf-image.png?fit=max&auto=format&n=jMF4bYA9yOA_2TKv&q=85&s=c5588c15b19aa4c75c61bb6becf4bbb4" alt="" width="3120" height="884" data-path="images/docs/288d6cef5253d83ea06afdd629c8b3f2a0221aa1f689da46f4849c504db8aacf-image.png" />

14. Test enrollments to ensure that the adapter is working properly.

***

[Change PIN - Shared Workstation](/docs/change-pin-shared-workstation)

[Establish Cloud Kerberos Key Trust - for Entra Joined Devices](/docs/establish-kerberos-key-trust-only-for-hybrid-joined-devices-1)