Configuring vStor System Settings

To access vStor’s systems settings, select the System tab from the navigation menu.

Host name

This section allows you to configure the hostname and domain name of your vStor system. These settings are important for identifying your system within your network and for accessing it remotely.

Host name

The primary name assigned to your vStor system. This name should be unique within your network and should adhere to hostname naming conventions.

Domain Name

The domain name that your vStor system belongs to.

Telemetry Data

To help improve vStor, you can choose to share usage data with Catalogic Software. You can choose the following options to control telemetry collection:

Collect telemetry data

Enables the collection of anonymous usage data.

Share collected telemetry data with Catalogic Software

Select this option to send the collected telemetry data to Catalogic Software.

Certificates

This section allows you to see the list of available certificates in Catalogic vStor and see their expiration date, add or overwrite a custom certificate, and select a certificate to use from either the built-in certificate or custom certificate.

See also. For more details on Certificates in Catalogic vStor, see Certificates in Catalogic vStor.

Debug Logging

For in-depth troubleshooting, you can enable more detailed logging of vStor processes:

Enable debug logging

Generates detailed logs for troubleshooting vStor backend processes.

Firewall

If you want to enable or disable the vStor firewall, select an appropriate option from the dropdown menu:

General Settings

This section allows you to configure various system-wide preferences for your vStor installation. You can adjust the following settings:

Async snapshot creation timeout

Defines the maximum time (in seconds) that vStor will wait for an asynchronous snapshot creation operation to complete before marking it as failed.

Configuration retention time

Determines how long (in days) vStor will store configuration backups.

Dashboard refresh time

Specifies the interval (in seconds) at which the vStor dashboard will automatically update to display the latest information.

Mount file systems limit

Specifies the maximum number of file systems that can be simultaneously mounted during agentless file restores.

Mounted file system volume retention timeout

Controls the default amount of time (in minutes) that a mounted volume from an agentless file restore will remain accessible before being automatically unmounted.

NFS server threads

Adjusts the number of threads allocated to the NFS server component within vStor. Increasing this value can potentially improve performance when serving multiple NFS clients concurrently.

Snapshot creation timeout

Defines the maximum time (in seconds) that vStor will wait for a snapshot creation operation to complete before marking it as failed.

Timezone for replication schedule

Specifies the timezone that will be used when scheduling replication tasks. This ensures replications occur at the desired time within your local time zone.

NTP

By default, vStor uses your machine’s locale to determine the current time.

To configure NTP settings, you need to provide the following information:

NTP Timezone

Choose a new timezone from the dropdown list.

NTP Servers

If you wish to specify an NTP server, provide its address.

Volume creation timeout

Defines the maximum time (in seconds) that vStor will wait for a volume creation operation to complete before marking it as failed.

Changing NTP server using vStor CLI

To configure email settings using vStor CLI, use the following command and specify the address of the server:

vstor system pref set --name NTPServers --value <server_address>

Global Deduplication Settings

vStor's deduplication feature helps optimize storage efficiency. You can adjust the deduplication behavior to your requirements through the following settings:

Buffer size for unique DDT entries

Sets the disk space threshold in bytes before unique entries in the ZFS deduplication table are evicted.

Disk usage size for unique DDT entries

Sets the disk space threshold in bytes at which unique deduplication table entries will start to be evicted.

Preload timeout

The time in seconds vStor waits for the deduplication table to load before becoming accessible.

Remove unique entries on next reboot

If enabled, removes unique deduplication table entries when the system is rebooted.

Sets deduplication limit on disk

Defines the maximum disk space the deduplication table can use (in bytes) before ZFS deduplication is disabled on the pool.

Sets deduplication table in memory

Sets a percentage threshold for memory usage. If exceeded, deduplication on the pool will be disabled.

Encryption Keystore Location

vStor allows you to specify the location of your encryption keystore for enhanced data security. To do that, provide the following details:

User

The username to access the encryption keystore.

Passwords

The password to access the encryption keystore.

Host

The hostname or IP address where the keystore is located.

Port

The port on which the keystore service listens.

Path

The file path to the encryption keystore.

Replication Settings

To fine-tune how vStor replicates data to other systems, you can adjust the following settings:

Bandwidth limit

The maximum bandwidth in bytes per second allowed for replication traffic.

Management timeout

The maximum time (in seconds) vStor will wait for a response from replication partners.

Maximum replication streams

The maximum number of replication streams that can run at the same time.

Stream compression

Specifies if data should be compressed during replication transfers.

Transfer timeout

The maximum time (in seconds) allowed for a single replication transfer to complete.

Email Settings

You can enable email notifications for your vStor instance to inform you about events like failed replication, pool free space below 10%, and more.

To configure email notifications, you need to provide the following information:

SMTP Host

Your SMTP server address.

SMTP Port

The port your SMTP server uses (usually 25, 465, or 587).

SMTP Username

Your SMTP server authentication username.

SMTP Password

Your SMTP server authentication password.

Recipients

A list of email addresses that will receive notifications.

Configuring Email Settings using vStor CLI

To configure email settings using vStor CLI, use the following command and specify the address of the server, list of recipients and the email credentials:

vstor system mail set --host <server_hostname> --user <email_username> --password <email_password> --recipients <email_recipients> 

Last updated