Installation overview
You can install NetVault by using the interactive or non-interactive installation method. You can also use the push installation method to simultaneously install the NetVault Client software on multiple Windows and Linux-based machines. This section provides an overview of the NetVault installer and available installation methods.
It includes the following topics:
The NetVault installer is offered as a single file —typically an application. The installation file is named as follows:
NetVault offers separate client-only and server-only installation packages for Linux and Windows-based systems. Both the server and the client packages are available in pure 64-bit versions.
NetVault supports installations in the following languages: English, Simplified Chinese, French, German, Japanese, and Korean. The installer automatically detects the system language and uses it as the default language. On systems that use an unsupported language, the installer defaults to English.
You can run the NetVault installer in graphical, text, or unattended mode. These modes are available for both new and upgrade installations. This section provides an overview of the available installation modes.
Use the graphical mode to install the software interactively from a graphical user interface. This mode is available on all supported operating systems that provide a graphical environment. The graphical mode requires GTK packages or X Window System libraries on Linux- and UNIX-based systems. The installer automatically runs in graphical mode if no installation mode is specified.
Use the text mode to install the software interactively from a text-based user interface. This mode is available on all supported operating systems, except Windows. On systems that do not provide a graphical environment, the installer automatically runs in text mode if no installation mode is specified.
Use the unattended mode to perform automated installations with minimal or no user interaction. This mode is supported on all operating systems. When performing unattended installations, you can specify the installation options at the command line or in an option file.
When running the NetVault installer, you can use the --mode option to specify the installation mode. Generally, you do not need to use this option because the installer automatically uses the default mode. If, for any reason, the default mode cannot be initialized, then the installer tries to use the alternative GUI or text modes, if available. For example, on Linux, if the GTK libraries are unavailable, the default gtk mode cannot be initialized. In such cases, the installer tries to use the xwindow mode, and if no X Server is detected, the installer defaults to text mode.
The following table lists the supported installation modes.
To run the installer in unattended mode, it is necessary to use the --mode option; the installer does not automatically switch to this mode. The --mode option is also required to run the installer in text mode on machines that support GUI (for example, to perform remote installations on Linux- or UNIX-based systems).
The installer generates a log file in the system temporary directory. The file is named as follows: netvault_{GUID}_install.log, where {GUID} is unique for each installation occurrence (for example, netvault_274bffb2-a3c1-457e-7f5e-221bf60a7689_install.log).
If the installation fails for any reason, you can examine the log file for details about the problem.
If an installation or upgrade is unsuccessful, the installer may not generate the regular log file. Instead, the installer may leave an intermediate log file is named bitrock_installer.log or bitrock_installer_nnn.log in the system temporary directory.
The push installation method lets you install one or more software packages on remote machines. You can use this method to install or upgrade the NetVault client and plug-ins on multiple machines. You can perform push installations from the NetVault WebUI. Push installation is available for Windows-to-Windows, Windows-to-Linux, Linux-to-Linux, and Linux-to-Windows scenarios. For more information about this method, see the Quest NetVault Administrator's Guide.
Installing NetVault in GUI mode
The graphical mode is available on all supported operating systems that provide a graphical environment. This mode requires GTK packages or X Window System libraries on Linux- and UNIX-based systems.
|
3 |
In the Language Selection dialog box, select the language for your NetVault installation. |
|
• |
Standard: This option allows you to use the NetVault Server in standalone mode. |
|
• |
Managed Service Provider: This option allows you to use NetVault Server and provide backup as a service to clients or customers. |
|
6 |
In the License Agreement dialog box, select the I accept the agreement option if you accept all the terms. |
|
8 |
In the Installation Directory dialog box, specify the installation path. |
Select the Yes option, and then click
Next to continue.
|
9 |
In the Machine Name dialog box, specify a unique name for the NetVault Server. Click Next. |
|
10 |
In the Machine Password dialog box, specify a password for the NetVault machine. |
In the Retype password box, type the password again for confirmation. Click
Next.
In the Database Directory box, specify the installation path for the NetVault Database.
|
• |
Linux user name: Select this option if you want to use the already existing Linux user account. |
In the Password box, specify a password for the PostgreSQL database super user.
In the Retype password box, type the password again for confirmation.
|
14 |
In the Ready to Install dialog box, review the installation parameters, and click Next to begin installation. |
Installing NetVault in text mode
The text mode is available on all supported operating systems, except Windows.
Press y to accept the license agreement and continue.
Press Enter if you want to select the default option.
|
11 |
In the Ready to Install screen, review the installation parameters, and press Enter to begin installation. |
Installing NetVault in unattended mode
The unattended mode is supported on all operating systems. When performing unattended installations, you can specify the installation options at the command line or in an option file.
An option file is a text file that provides answers to the questions that would be asked during the installation process. Each answer is stored as a value for a variable identified in the option file. You can save the option file in any directory and assign it any valid filename.
The installer uses the default values for options that are omitted (except for the password for PostgreSQL Database Superuser, which does not have a default value).
You can specify the following parameters at the command line or in the option file.
|
|
|
|
--unattendedmodeui <interaction level> |
Specifies the interaction level for the unattended installation.
The allowed values are:
|
• |
none: This is the default mode for unattended installations. In this mode, the installer does not display any prompts or progress information. |
|
• |
minimal: In this mode, the installer does not display any prompts, but it provides the progress information through pop-up windows. |
|
• |
minimalWithDialogs: In this mode, the installer displays some prompts, and it provides the progress information through pop-up windows. | |
|
--optionfile <filename> |
Specifies the name of the option file. Provide the full path if the file does not reside in the current directory. |
|
--installer-language <NetVault language> |
Specifies the language for your NetVault installation. The supported languages are:
The default is English (en). |
|
--setup-type <setup-type> |
Specifies the setup type for NetVault Server. The setup type can be:
|
• |
Standard: This is a default option and enables you to use the NetVault Server in standalone mode. |
|
• |
MSP: This option enables you to use NetVault Server and provide backup as a service to clients or customers. The Managed Service Provider (MSP) option is supported on the Windows and Linux Server pure 64-bit versions. | |
|
--prefix <installation directory> |
Specifies the installation path for NetVault. If the path contains spaces, enclose it in quotation marks (“ ”).
The default path is as follows:
|
|
--logical-name <NetVault machine name> |
Specifies the NetVault machine name.
By default, NetVault uses the OS-assigned machine name. For more information about machine names, see Determine NetVault name and password. |
|
--password <password> |
Specifies the NetVault machine password.
The machine password is used while adding a NetVault Client to the server. The password can contain a maximum of 100 characters. It cannot contain the following characters:
\ and spaces
For more information about passwords, see Determine NetVault name and password.
If no password is set during installation, NetVault uses the system’s root or administrator password. |
|
--db-dir <NetVault Database installation> |
Specifies the installation path for NetVault Database. This parameter can only be specified for NetVault Server installations.
If the path contains spaces, enclose it in quotation marks (“ ”).
The default path for NetVault Database is as follows:
|
|
--pg-linuxuser-option <pg-linuxuser-option> |
Specifies the option for PostgreSQL Linux user account. For more information about NetVault PostgreSQL Linux user account, see Determine NetVault PostgreSQL Linux user account. The default option will be selected if you do not provide the input here.
Default: auto
Allowed: auto custom |
|
--pg-linuxuser-name <pg-linuxuser-name> |
Required only when --pg-linuxuser-option is set to custom.
Default: netvault-pgsql |
|
--pg-su-passwd <password> |
Specifies the password for PostgreSQL Database Superuser. This parameter can only be specified for NetVault Server installations.
The password can contain a maximum of 100 characters. It cannot contain the following characters:
\ and spaces
For more information about specifying a password for the PostgreSQL database super user, see Determine NetVault name and password. |
This section provides some examples of using the NetVault installer in unattended mode.
./<Name of the installation file> --mode unattended --pg-su-passwd MyDbPassword
./<Name of the installation file> --mode unattended --installer-language ja
--pg-su-passwd MyDbPassword
./<Name of the installation file> --mode unattended
./<Name of the installation file> --mode unattended --installer-language ja
This section provides some sample option files.
