# Unpairing Sensor from Brain

## Introduction

Unpairing is the process of removing the sensor and brain association. The sensor unpairing may be required in case of :

1. Brain migration to new IP.
2. The sensor is being returned to Vectra.

Related Links:

* [Pairing Physical Sensors](broken://pages/blRNiOQebqQnfaYQyFIl)
* [How do I clear data from a Vectra Cognito brain or sensor before returning the appliance?](broken://pages/mEdLAqVZ1KmYhzbpAuD1)

## Preparation:

1. You can see the list of paired sensors and the list of sensors available for pairing from the "brain\_web\_UI -> Data Sources -> network -> Sensors":\
   Note: On Cognito Detect Version 7.3 and below: Manage → Sensors:\
   ![](/files/laZt6d4qbaUrP9YRtcWN)\
   The status column indicates whether the sensor has been paired (i.e. Forwarding / Not-forwarding) or is available for pairing (i.e. Provisioned / Pairing). Sensors that have been paired with other brain devices are not listed on this screen.

## Steps:

#### From the UI

1. Go to "Brain\_Web\_UI -> Data Sources -> Network -> Sensors".
2. Hover the cursor over the sensor you want to unpair; to see the unpair icon (Marked with a red border in the below picture). Click on it.\
   ![](/files/vpi5TGLmwshoqdMALDAa)
3. The pop-up show like the below screen. Click on the "Unpair Sensor" button ![](/files/jnTiY7opG2k0AW2V1y44)\
   The status of sensor will chnage to unpairing.\
   ![](/files/sCa2Tf1Ju7PquLULA3ZV)
4. Wait for approx 5 minutes; the sensor status should chage to "Provisioned" .\
   ![](/files/npEMqCDBOThVnQDTAPfm)
5. There may be situations when the brain is not able to reach the sensor; in that case:
   1. Click on unpair button again.\
      ![](/files/d0c2aUrzICr8jNmawOzN)
   2. The pop-up will appear . Click on "Force Unpair Sensor".\
      ![](/files/cIQzA6WTzyeRAMTS22VL)\
      If the sensor is a Virtual Sensor, just delete the sensor image; and if it's a physical sensor then login to sensor VCLI as a 'vectra' user, and run the command

      ```ckeditor_codeblock
      show brain
      del brain
      show brain
      ```

      The sensor unpairing is complete now.

#### From CLI

1. To list the sensor:

   ```language-c
   show sensors
   ```
2. Now, to unpair (*replace \[SERIAL] by the sensor serial number*):

   ```language-c
   sensor unpair [SERIAL]
   ```
3. In special cases, for example, if a virtual sensor was deleted from the host before unpairing it, you will can force the removal:

   ```language-c
   sensor unpair --force [SERIAL]
   ```

####

#### **Unpairing Cloud Sensor:**

1. Login to the QUX/RUX portal > Data sources > Select cloud sensor (AWS CloudTrail, Azure AD & M365) and expand it.
2. Click on the “Delete” icon\
   ![](/files/ZimpkXcMDh1m8QNUO3uT)
3. It will ask for the confirmation page, select “Remove Connection”\
   ![](/files/R8KEeqS3BYUSiEhznDnH)
4. Wait for 2 minutes, and the cloud sensor will disappear.

## Verification:

1. The Sensor state should be at the 'Available' state at "Brain\_Web\_UI -> Data Sources -> Network -> Sensors".\
   ![Sensor Available for pairing](/files/quu9ptdBbm3ti3NfmeeM)
2. In the case of the Physical Sensor, the following VCLI command should give \<blank> result.

   ```ckeditor_codeblock
   show brain
   ```

## Troubleshooting:

If prerequisites are passing then sensor pairing can go as easily as it can be; however in case of any issue please contact Vectra support. If possible, please add the following information to the ticket:

1. Output of VCLI commands on Sensor:

```ckeditor_codeblock
show serial-number
show version
show brain
show interface
```

2. Output of VCLI commands on the brain:

```ckeditor_codeblock
show serial-number
show version
show interface
```

```
 
```

3\. Screenshot of sensor detail at: "brain\_web\_UI -> Data Sources -> Network -> Sensors"; then scroll to the sensor in the subject and click on the tree.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vectra.ai/deployment/appliance-operations/unpairing-sensor-from-brain.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
