NetVault 13.1.2 - Administration Guide


	NOTE: You must be logged-in with Administrator privileges on Windows-based systems and root user privileges on Linux- and UNIX-based systems to use these utilities.

To manually start or stop the NetVault Service:

Using Txtconfig:

In a terminal or command prompt window, type, txtconfig, and press Enter or Return.

On the Machine page, press p to view the main menu, and then press the option number for the Services page.

Depending on the current state of the NetVault Service, press the option number to stop or start the service. Press s, and then press q.

Using CLI:

On Linux-based systems:

To start the service, type: $NV_HOME/etc/startup.sh start

To stop the service, type: $NV_HOME/etc/startup.sh stop

On Windows-based systems:

To start the service, type: net start “NetVault Process Manager”

To stop the service, type: net stop “NetVault Process Manager”

Enabling Web Service over HTTP or HTTPS

By default, the Web Service is enabled over HTTPS. You can modify the Web Service settings to change the port or protocol. These settings also let you specify the security certificate file and private key file for HTTPS communications.

You can modify the Web Service settings through the following interfaces: NetVault WebUI (through the Change Settings page), or Txtconfig.


	NOTE: NetVault uses port 8443 as the default HTTPS listen port for incoming Web Service connections. When installing the server, if the default port (8443) is in use by any other application, NetVault assigns the first available port in the port range 50486 to 65535. You must be logged-in with Administrator privileges on Windows-based systems and root user privileges on Linux- and UNIX-based systems to use this procedure.

To configure the Web Service settings for NetVault:

Access the Web Service settings by using any of the following methods:

•

NetVault WebUI:

Start the NetVault WebUI, and in the Navigation pane, click Change Settings.

On the NetVault Server Settings page, under Services, click Web Service.

•

Txtconfig:

In a terminal or command prompt window, type, txtconfig, and press Enter or Return.

On the Machine page, press p to view the main menu, and then press the option number for the Web Service page.

Configure the following settings.

Table 1. Web Service settings

Setting

Description

HTTP settings

To access the Web Service through HTTP, configure the following settings:

•

Enable Web Service over HTTP: Select this check box.

If you are using Txtconfig, press the option number for this setting to change the value to ON.

•

HTTP Listen port for incoming Web Service connections: The default HTTP port is 80.

If this port is in use by any other server or application, configure an alternate port.

HTTPS settings

To access the Web Service through HTTPS, configure the following settings:

•

Enable Web Service over HTTPS: This protocol is selected by default.

HTTPS is the preferred protocol. This protocol provides encrypted communication between the client and server. It protects sensitive data such as NetVault passwords passed between the browser and NetVault Web Service.

•

HTTPS Listen port for incoming Web Service connections: By default, NetVault uses port 8443 for HTTPS. If this port is in use by any other server or application, configure an alternate port.

•

WebService security certificate file: To use HTTPS, provide a SSL certificate.

NetVault provides a self-signed certificate (server.crt), which resides in the etc directory under the NetVault installation directory. This certificate generates warnings in most browsers.

For the browser to accept a certificate without warnings, provide a valid certificate file signed by a trusted certificate authority.

•

Ciphers to disable for incoming Web Service connections: You can modify the Web Service configuration to disable ciphers for incoming web service connections settings to prevent from allowing one or more ciphers. These settings can be configured from the NetVault Server Settings page. By default, this field is blank and all the ciphers are allowed.

•

Protocols to disable for incoming Web Service connections: You can modify the Web Service configuration to disable protocol for incoming web service connections settings to prevent from allowing one or more protocols. These settings can be configured from the NetVault Server Settings page. By default, this field is blank and all the protocols are allowed.

•

WebService private key file: Provide the private key file required for HTTPS communications.

The default key file is server.key, which resides in the etc directory under the NetVault installation directory.

To save the settings, do the following:

•

NetVault WebUI: Click Apply to apply the settings and close the WebUI dialog box.

•

Txtconfig: Press s to save the settings, and then press q to quit Txtconfig.

Logging in to NetVault

The following options are available for logging in to the NetVault Core:

•

NetVault local user

•

Active Directory Domain (AD) user

•

OpenLDAP Directory Services user

•

Samba Active Directory user]

•

Microsoft Azure Active Directory (Azure AD) user


	NOTE: You must be logged-in with Administrator privileges on Windows-based systems and root user privileges on Linux- and UNIX-based systems to run NetVault. For more information about logging in using AD, see Integrating Active Directory with NetVault. Before logging in with the Azure AD option, register NetVault in the Azure portal and then configure Azure AD in NetVault. For more information, see Using Azure Active Directory as an identity provider.

To log in to NetVault:

Open a browser window. In the address bar, type:

https://<machine-name>:8443

Press Enter.

In the Login dialog box, complete one of the following options:

•

To log in using NetVault local or Domain user credentials, type your user name and password, and then click Sign In.

NOTE: There are two predefined user accounts in NetVault:

•

admin: The administrator account for NetVault.

•

default: A standard user account that can be used to perform various operations in NetVault.

After installing NetVault, you can use either the admin or the default user account to log in to NetVault. By default, no password is assigned to these user accounts.For more information about NetVault user accounts, see Managing user and group accounts.

•

To log in using Azure AD credentials, click Sign in with Azure AD, enter the appropriate credentials, and then click Enter.

After you log in, the WebUI opens the Server Monitor page in your browser window.

Overview of NetVault WebUI

The NetVault WebUI consists of the Header pane, Navigation pane, and Operations pane.

Figure 2. NetVault WebUI home page

The following table provides a brief description of the WebUI panes:

Table 2. NetVault WebUI panes

Pane

Description

Header pane

This pane includes the following items:

•

Video icon: Provides access to the video tutorial for the currently loaded page. The link opens in a new browser window or tab.

•

Language: Displays the list of available languages from which you can select the display and input language for NetVault WebUI.

This option does not change the locale setting for NetVault. To change the locale for NetVault, see Changing language and locale settings.

•

Settings icon: Displays the list of options to change Application Settings, Clear NetVault cache, and Clear NetVault UI Preferences.

Application Settings

To change the Application Settings (Navigation, Color Palette, Show Actions as, Time Formatting and Default Table Pagesize) for NetVault WebUI, follow these steps:

In the header pane of NetVault WebUI, click the Settings icon and select Application Settings. Application Settings drawer is displayed on the right- side of the page. Configure the following options:

•

Navigation: To remove the auto-hide setting of navigation bar in the NetVault WebUI, clear the Auto-hide Navigation Drawer check box. By default, the navigation bar is set to auto-hide.

•

Color Palette: To change the color theme of NetVault WebUI to dark theme, select the Dark theme. By default, the NetVault WebUI is displayed in Light theme.

•

Show Actions as: To view the Actions option as a page-level and table-level context menus, select Context menus. By default, the action options are displayed as buttons on bottom of the NetVault WebUI pages.

When you select the Context Menus option, the page-based action buttons on the bottom of the page are replaced with a context menu shown as Horizontal Ellipsis icon at the top of the page (after the page title). Also, the table-based actions are shown in the ‘Actions’ column in the table. Click the Horizontal Ellipsis icon and select the required action.This option is applicable to some of the NetVault WebUI pages.

•

Time Formatting: To change the time format, select 12-hour or 24-hour format from the application settings. By default, the application sets 24-hour time format from the server settings. Change the time format in following ways:

•

12-hour (AM/PM): Sets 12-hour (AM/PM) format of the NetVault WebUI.

•

24-hour: Sets 24-hour format for the NetVault WebUI.

NetVault applies time format configuration changes to all sections of NetVault WebUI except for report based features.

•

Default Table Pagesize: To change the default page size for tables in NetVault WebUI click the Default Table Pagesize drop down. If you have already configured the page size for respective tables from Table Settings, then these settings supersedes Application settings. By default, the application sets the page size to Auto from the server settings. You can change NetVault WebUI page size to the following options or you can manually enter page size number:

•

25: Sets the page size to display 25 records in a table.

•

50: Sets the page size to display 50 records in a table.

•

100: Sets the page size to display 100 records in a table.

•

500: Sets the page size to display 500 records in a table.

•

1000: Sets the page size to display 1000 records in a table.

Click OK.

You can select the preferred setting and persist it over browser sessions. To add server configuration defaults for Navigation pane, UI theme for NetVault WebUI, Show Actions as, Time Formatting, and Default Table Pagesize settings, see Configuring NetVault WebUI default settings.