# Adding a vStor Storage Node

Catalogic has developed the vStor server for efficient, safe and versatile data protection and recovery. This reliable tool, connecting to disk storage pools, acts as the primary destination for DPX. You can install the Catalogic vStor server as a virtual or physical appliance at any stage post-deployment of the Catalogic DPX Master Server.

Catalogic vStor servers can be deployed:

* on a physical machine
* in a VMware environment
* in a Hyper-V environment

Both block backups and agentless backups are supported for backups to and restores from a vStor server.

{% hint style="info" %} <mark style="color:blue;">**See also.**</mark> For more information about vStor, go to the [vStor 4.14 Documentation](https://docs.catalogicsoftware.com/vstor-4.14).
{% endhint %}

## Procedure

vStor storage nodes must be added manually from the DPX Master Server. The procedure is similar to [Adding a Client Node from the Master Server Level](https://docs.catalogicsoftware.com/dpx-4.14/installation-and-configuration/nodes/adding-a-client-node-from-the-master-server-level). There are differences in naming conventions and feature handling between the web interface and desktop interface. For details, see below.

{% tabs %}
{% tab title="Web interface" %}

1. Go to the **Nodes** section in the sidebar.
2. Click the **Add Node** button in the upper right corner.
3. Select **vStor** as the node type

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-7a831c16e0f9a6728ba2f0a68b3fed832281b206%2Fnodes-add_node-vstor.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

2. Complete fields required for nodes: specify the name for the new node, provide a valid resolvable hostname or IP address, and select the group for the node.

{% hint style="info" %} <mark style="color:blue;">**Note.**</mark> The Node Name must be unique throughout the Enterprise, regardless of the Node Group it is saved in.
{% endhint %}

{% hint style="info" %} <mark style="color:blue;">**Tip.**</mark> Providing the hostname is recommended over providing an IP address – in case the IP address changes, the hostname can still be resolved to the new IP address, and the connection between the server and the client will remain functional.
{% endhint %}

3. Complete the connection fields:
   * **User Name**

     Enter the User ID to log into the vStor node.
   * **Password**

     Enter the password to log into the vStor node with the User ID above.

{% hint style="warning" %} <mark style="color:orange;">**Restrictions.**</mark> Ensure that the vStor user permissions provided when adding the node are adequate for the intended tasks. Note that some DPX jobs may require vStor administrator permissions to function correctly.
{% endhint %}

{% hint style="info" %} <mark style="color:blue;">**Tip.**</mark> You can also use vStor API key and token as credentials for adding a vStor storage node. For more information, see [Connecting to DPX with an API Key](https://docs.catalogicsoftware.com/vstor-4.14/basic-configuration/adding-catalogic-vstor-node-to-catalogic-dpx/using-vstor-api-keys-with-catalogic-dpx#connecting-to-dpx-with-api-key) in vStor 4.14 Documentation.
{% endhint %}

4. Optionally, click **Test** to verify the credentials, and to confirm the connectivity with the vStor.
5. Click **Save**. The vStor storage node is now added to your Enterprise.

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-d3720cf078a42e85ffe5808fd2bd5248540a927f%2Fnodes%20-%20vStor%20node%20added.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Desktop interface" %}
Proceed with adding a node as described in [Adding a Client Node from the Master Server Level](https://docs.catalogicsoftware.com/dpx-4.14/installation-and-configuration/adding-a-client-node-from-the-master-server-level#desktop-interface).

1. Select **STORAGE\_CTL** as the access method. Additional fields will appear.
2. Select **vStor** as the Storage Controller Type.

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-ddf8f5eb58fb2ca7175da0245b1559a9cb1fbcf7%2FJAVA%20-%20configure%20-%20add%20vStor%20node%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

3. Complete fields required for nodes: specify the name for the new node, provide a valid resolvable hostname or IP address, and select the group for the node.

{% hint style="info" %} <mark style="color:blue;">**Note.**</mark> The Node Name must be unique throughout the Enterprise, regardless of the Node Group it is saved in.
{% endhint %}

{% hint style="info" %} <mark style="color:blue;">**Tip.**</mark> Providing the hostname is recommended over providing an IP address – in case the IP address changes, the hostname can still be resolved to the new IP address, and the connection between the server and the client will remain functional.
{% endhint %}

4. Complete the connection fields:
   * **User Name**\
     Enter the User ID to log into the vStor node.
   * **Password**\
     Enter the password to log into the vStor node with the User ID above.

{% hint style="warning" %} <mark style="color:orange;">**Restrictions.**</mark> Ensure that the vStor user permissions provided when adding the node are adequate for the intended tasks. Note that some DPX jobs may require vStor administrator permissions to function correctly.
{% endhint %}

4. Click **Add**. The vStor storage node is now added to your Enterprise and the newly added node is selected for edit.

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-a4b119617c89f487716c5f6109460c797881be80%2FJAVA%20-%20configure%20-%20vStor%20node%20added.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}
