NetVault 13.3.2 - Administration Guide


	NOTE: Sometimes, due to policy restrictions on your system, the NetVault on Linux operating system is unable to create new catalog search Linux user account automatically.

While installing NetVault catalog search, you can select any of the following options for catalog search Linux user account:

•

Allow NetVault to create catalog search Linux user: The default option to allow NetVault to create Catalog search Linux user account automatically (default value: netvault-catalog on Linux).

•

Linux user name: Create a new Linux user account by referring to the corresponding operating system guide. Ensure that the specified catalog search Linux user belongs to the group <user name>. Create the group with the same name as of the Linux user name and add the user into the same group.


	NOTE: While creating a catalog search Linux user account, do not use ‘root’ user in the field ‘Linux use name’. In NetVault, catalog search cannot run by a ‘root’ user due to restrictions from Elasticsearch component.

•

Create the required Catalog Search directories.

•

Catalog Search will use these directories to store its data. These directories need the correct permission. Allow group users to create files and directories.

•

Catalog Search database consists of Database, Snapshot, and Log.

•

Catalog Search can be configured to store Snapshot and Log in the Database directory. In this case, only one directory needs to be created for the database.

•

If Catalog Search is configured for Snapshot and Log to reside in different directories then create the Database, Snapshot, and Log directories separately.


	NOTE: Catalog search sets the system level JAVA_HOME environment variable that is required for Elasticsearch. Hence, the other java applications may not work. It is assumed that the NetVault Server is a dedicated server.

Configuring catalog search

To enhance searching for files in savesets, you must install and configure the catalog search service on NetVault Server running on Windows or Linux operating systems.

To install and configure the catalog search:

In the Navigation pane, click Catalog Search.

On the Catalog Search Configuration page, provide the following details.

Table 22. Catalog search configuration options

For Linux: Displays the name of the NetVault Server to install the catalog search server.

For Windows: Displays the name of NetVault Server and Client to install catalog search. However, NetVault Server and Client must be of the same version.

Catalog Search Password

Type the password for the catalog search database. It cannot contain the following characters:

& < > | ^ spaces

By default, ‘admin’ is used as the password if this field is kept empty during catalog search installation.

Confirm Catalog Search Password

Type the password again for confirmation.

Existing Linux User (for Linux only)

For Linux operating system, type the existing Linux user name. Do not use the ‘root’ as a user name. For more information, see Prerequisites.

Database Directory

NOTE: Create the Database Directory manually.

Click Browse to select the database directory for catalog search:

•

‘Database Directory’ drawer is displayed on the right- side of the page.

•

Open the parent node, browse through the directory tree, and locate the directory to store the catalog search database.

•

The selected directory path is displayed in the text box.

•

Click OK.

NOTE: To enter the Database Directory path manually, ensure that all the directory(s) and sub-directories must be already created and available.

NOTE: If the Database directory is created using the NetVault UI's 'New Folder' option, grant it additional permissions manually before configuring.

Use same path for Snapshot and Log Directory

By default, the check box is selected and the Snapshot Directory and Log Directory fields are disabled, hence the Database Directory path is copied and same path is set for Snapshot Directory and Log Directory.

Clear the check box to enable and edit the Snapshot Directory and Log Directory field.

Snapshot Directory

NOTE: Create the Snapshot Directory manually.

Click Browse to select the location to store the catalog search database backup.

•

‘Snapshot Directory’ drawer is displayed on the right- side of the page.

•

Open the parent node, browse through the directory tree, and locate the directory to store the catalog search database backup.

•

The selected directory path is displayed in the text box.

•

Click OK.

NOTE: To enter the Snapshot Directory path manually, ensure that all the directory(s) and sub-directories must be already created and available.

Log Directory

NOTE: Create the Log Directory manually.

Click Browse to select the location to store the catalog search logs.

•

‘Log Directory’ drawer is displayed on the right- side of the page.

•

Open the parent node, browse through the directory tree, and locate the directory to store the catalog search logs.

•

The selected directory path is displayed in the text box.

•

Click OK.

NOTE: To enter the Log Directory path manually, ensure that all the directory(s) and sub-directories must be already created and available.

Server Snapshot Path

Specify the shared directory path of Snapshot Directory. The format of Server Snapshot Path is <\\IP address of client>\shared snapshot directory>. Ensure the snapshot directory is shared to make it available for NetVault database catalog backup and restore operation on Windows Client.

This field is available and visible only if the Catalog Host is selected as remote windows client.

Once catalog search is installed on Windows Client, configure client host credentials:

To configure client host credentials:

Click Configure, to configure the connection details for accessing shared server snapshot path of client host.

Enter the following detail, and click Ok.

•

Domain: Type the Windows Domain name for the system that contains the shared folders.

•

Username: Type a Domain Administrator user name. The network share backups must be performed using a Domain Administrator account to fully retrieve the file and directory permissions during a restore. A user belonging to the Administrators Group does not have the Domain Administrator privileges.

NOTE: If a Non-Domain Administrator account is configured for backups, the file and directory permissions must be set manually after a restore.

•

Password: Type the password for the user account.

HTTP Port

Specifies the HTTP port for Catalog Search.

You can specify the port number range from 9200-9299 for catalog search on which the NetVault Server will communicate. You can also configure the port after NetVault Server is installed, and then restart catalog search service.

Configuration

Reserved RAM Size (GB)

This is the amount of RAM that the catalog search service attempts to pre-allocate before it starts. If the RAM isn’t available the service won’t start.

By default, the value is set to 1GB. Type or select the required RAM size. For systems with Large RAM size, a higher value is recommended (2 – 16 GB, based on the item backup rate and availability of RAM, limited by the restrictions mentioned in the Prerequisites section).

Maximum simultaneously active catalog workers

By default, 5 concurrent catalog workers can run on the server.

To change the number of catalog workers that can be run in parallel at any time, type or select the new value.

Minimum value: 1

Maximum value: 20

Add pre-existing and scanned backups to catalog

Select this check box to include the pre-existing and scanned backup jobs for catalog searching. By default, the check box is clear.

Include backups with offline indexes

Select this check box to include the backup jobs with offline indexes for catalog searching. By default, the check box is clear.

You can select this option only if the option Add pre-existing and scanned backups to catalog is selected.

Offline index load wait (Minutes)

This is the amount of time the catalog search service will wait for an offline index for a pre-existing backup to be loaded. If the media manager doesn’t load the offline index within this wait time, cataloging of this pre-existing backup will be temporarily skipped. Eventually, the skipped pre-existing backup will be cataloged, with the timing depending on how many other pre-existing backups are available for cataloging.

Type or select the duration (in minutes) to wait for loading the offline index during catalog indexing. By default, the minimum value is set to 10 minutes.

Startup offline index load wait (Minutes)

This is the minimum time from the last NetVault start time before the catalog search service requests the media manager to load an offline index. This delay from the last NetVault start is required to allow the media manager to complete its device scan to determine which devices are available. If a device is unavailable or hasn’t been scanned to determine its availability at the time of receipt of an offline index request, the media manager fails the request without trying to load the offline index.

Type or select the duration (in minutes). By default, the minimum value is set to 10 minutes.

Restrict the age of backups added to the catalog

Select this check box to restrict the pre-existing backup jobs for catalog searching.

By default, the check box is clear.

You can select this option only if the option Add pre-existing and scanned backups to catalog is selected.

Add backups completed on and after

To include the backup jobs completed on and after a specific date in the catalog search, type the date, or click the button next to the box, and select the date.


	NOTE: You cannot change the directories (Database Directory, Snapshot Directory, and Log Directory) after catalog search configuration. If you must change the directories, you can uninstall the catalog search and then reinstall using different directories. However, you have to re-catalog your existing backups, which can take a long time.

Click Install And Configure.

Relocating the catalog search database directory

To relocate the catalog search database directory, use the procedures described in the following sections:

•

Changing the NetVault Catalog Database directory on a Windows-based machine

•

Migrating NetVault Catalog Server to different Windows-based client machine

•

Changing the NetVault Catalog Database directory on a Linux-based machine

Changing the NetVault Catalog Database directory on a Windows-based machine

To change the Catalog Database Directory on a Windows-based NetVault Server:

Disable the catalog search, see, Disabling catalog search.

Stop NetVault Catalog Search service from the Windows Services Management Console.

Manually move the db directory to the new location. Make sure that the user under which the netvault-catalog service runs has the ownership of the new Database Directory.