> For the complete documentation index, see [llms.txt](https://docs.vega365.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vega365.com/nidhi/getting-started/installation.md).

# Installation

## Obtain Software

Email <sales@vega25.com> with the number of recording servers to protect. You receive the Nidhi setup (`Nidhi-1.0.<build>.msi`) and a licence ID and password for each recording server, for a trial or an annual subscription.

## What gets installed where

One setup file installs both parts. You choose the parts on the setup's **Custom Setup** page:

| Part                                               | Install it on                                                            | What it is                                                                                                                                                                                            |
| -------------------------------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Management Client plugin**                       | Each PC where you use the XProtect Management Client to look after Nidhi | The Nidhi Dashboard in the Management Client. It also carries the Nidhi Recorder Service, and installs and updates it on the recording servers over the network (**Settings > Software management**). |
| **Nidhi Recorder Service (this recording server)** | A recording server the Management Client can't reach over the network    | Installs Nidhi on this recording server directly.                                                                                                                                                     |

The usual way is to install the plug-in on the Management Client PC, then install Nidhi on all recording servers from there. Install on a recording server directly only when its [Software management ports](https://docs.vega365.com/nidhi/getting-started/ports.md#between-the-management-client-and-the-recording-servers) can't be opened.

The setup runs only on a computer with the XProtect Management Client or an XProtect Recording Server.

{% stepper %}
{% step %}

### On the Management Client PC

* Close the XProtect Management Client.
* Double-click `Nidhi-1.0.<build>.msi` and click **Next**.
* On **Custom Setup**, keep **Management Client plugin** selected and click **Next**, then **Install**. Windows asks for administrator rights.

<figure><img src="https://1044727958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOkTZH1L3AaRU2hwQk4Ve%2Fuploads%2Fgit-blob-ede4fe5936aae71d2ecaad185c6c88852949e651%2Fmsi-custom-setup.png?alt=media" alt=""><figcaption><p>Custom Setup on a Management Client PC: the Nidhi Recorder Service is left out</p></figcaption></figure>

* Click **Finish**.
* Open the Management Client. **Nidhi** appears under **MIP Plug-ins** in the Site Navigation pane, with the **Dashboard** under it.
  {% endstep %}

{% step %}

### On the recording servers

* In the Management Client, open **MIP Plug-ins > Nidhi > Dashboard**. Recording servers without Nidhi show **Nidhi is not installed on this recording server**.
* Click **⚙ Settings > Software management...** and choose **Update Nidhi on recording servers**.
* Recording servers without Nidhi, or with an older one, are already ticked. Untick any you want to leave for now.

<figure><img src="https://1044727958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOkTZH1L3AaRU2hwQk4Ve%2Fuploads%2Fgit-blob-bfde2a842b7cf548331d6eb6028f39a6e2301010%2Fmc-install-recorders.png?alt=media" alt=""><figcaption></figcaption></figure>

* Click **Next** through to **Install**. See [Software Management](https://docs.vega365.com/nidhi/management-client/software-management.md).

{% hint style="info" %}
The recording servers keep recording during the installation, and no restart is needed.
{% endhint %}
{% endstep %}
{% endstepper %}

### On a recording server

For a recording server the Management Client can't reach over the network:

* Copy `Nidhi-1.0.<build>.msi` to the recording server and double-click it.
* On **Custom Setup**, select **Nidhi Recorder Service (this recording server)**, click **Next**, then **Install**.

<figure><img src="https://1044727958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOkTZH1L3AaRU2hwQk4Ve%2Fuploads%2Fgit-blob-f2b306b5a2b55951a65fbfab99bc2a7c3180bafd%2Fmsi-custom-setup-recorder.png?alt=media" alt=""><figcaption></figcaption></figure>

* Click **Finish**. The Nidhi Recorder Service starts. Open the Dashboard in the Management Client to set the recording server up.

The service is installed in `C:\Program Files\Vega Systems Inc\NidhiRecorderService`. WinFsp, which the cloud drive needs, is installed with it.

{% hint style="info" %}
Nidhi is installed in:

* `C:\Program Files\Milestone\MIPPlugins\Nidhi` (the Management Client plug-in),
* `C:\Program Files\Vega Systems Inc\NidhiRecorderService` (the Nidhi Recorder Service),
* `C:\ProgramData\Vega\Nidhi` (the service's state and the default cache).
  {% endhint %}

## Silent Installation

Run with administrator rights, choosing the part with `ADDLOCAL`:

```
msiexec /i Nidhi-1.0.<build>.msi ADDLOCAL=Plugin /qn /l*v "<Path_to_log>.txt"
msiexec /i Nidhi-1.0.<build>.msi ADDLOCAL=RecorderService /qn /l*v "<Path_to_log>.txt"
```

`ADDLOCAL=Plugin,RecorderService` installs both. Without `ADDLOCAL`, only the plug-in is installed, and only where the Management Client is. On a recording server without the Management Client, the installation stops with *Nothing to install: no part of Nidhi was chosen*, so always add `ADDLOCAL=RecorderService` there.

## Updating Nidhi

Update the plug-in first, then the recording servers:

<figure><img src="https://1044727958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOkTZH1L3AaRU2hwQk4Ve%2Fuploads%2Fgit-blob-c68aea4106ea3afd6d55ff029e9259d54edbdfda%2Fmc-software-management.png?alt=media" alt=""><figcaption></figcaption></figure>

1. In the Management Client, open **⚙ Settings > Software management...** on the Dashboard and choose **Update the Nidhi plugin**. Pick the new setup file and click **Install**. The installer asks for an administrator and to close the Management Client. Open the Management Client again when it is done. (Or close the Management Client and run the new setup on that PC.)
2. Then choose **Update Nidhi on recording servers**. Recording servers with an older Nidhi show **Update available**. See [Software Management](https://docs.vega365.com/nidhi/management-client/software-management.md#install-or-update).

Settings, licences and the cloud drive are kept. The cloud drive **stays mounted** through the update, so XProtect keeps archiving and playing back. Only when the running Nidhi is too old to hand the drive over does the update stop the Recording Server for a minute or two (it says so first).

The Dashboard's top line says when recording servers run an older Nidhi than the Management Client: **N recorders run an older Nidhi — Update...**

{% hint style="info" %}
Nidhi never installs an older version over a newer one. Update the plug-in on the Management Client PC before the recording servers, because a Management Client can only install the version it carries.
{% endhint %}

## Uninstallation

### From a recording server

In the Management Client, remove Nidhi from recording servers with **⚙ Settings > Software management... > Remove Nidhi from a recording server**. See [Remove Nidhi](https://docs.vega365.com/nidhi/management-client/software-management.md#remove-nidhi). It checks first that XProtect no longer archives to the cloud drive and that all uploads are done, then frees the licence, unmounts the drive and removes the service.

On the recording server itself, use **Settings > Apps > Nidhi Recorder Service > Uninstall** (or the Nidhi setup's **Remove**). It makes the same checks.

{% hint style="warning" %}
**First take the archive off the cloud drive in XProtect.** While a storage profile archives to the cloud drive, Nidhi isn't removed, because XProtect would lose its archive. Footage already in the cloud stays there. Nidhi deletes nothing in the cloud.
{% endhint %}

### From the Management Client PC

* Close the Management Client.
* Open **Settings > Apps** (or **Control Panel > Programs and Features**), select **Nidhi for Milestone XProtect** and click **Uninstall**.

<figure><img src="https://1044727958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOkTZH1L3AaRU2hwQk4Ve%2Fuploads%2Fgit-blob-64c84aa4049b1565a61ef2f4cfe48605836d4b26%2Fwin-uninstall-plugin.png?alt=media" alt=""><figcaption></figcaption></figure>

Removing the plug-in doesn't change the recording servers. They keep protecting their footage.
