The setup programs of the individual BVQ modules were grouped together to a larger installation package called the 'Repository Installer'.  

Thus, only a single setup file bvq-package-repository-installer-<version>.exe has to be started on the BVQ Server or BVQ Client which contains now all the necessary modules. Common configuration parameters, such as DB access data, service user and directories have to be entered only once now. This makes the installation of BVQ  much faster, safer and easier.   

The Repository Installer places the individual modules in the subdirectory bvq-installer\repository of the BVQ installation directory and calls them in an optimal order. The separate call-up of just a single module is still possible.   

 

Installation modules of the Common Installer (Repository Installer)

The installation of BVQ is divided into the respective BVQ modules. Each module has its own wizard, which guides the user through the installation. The individual modules are summarized in the 'Repository Installer'.

Installation module

Installation file

Description

BVQ DB Setup

bvq-db-setup-installer<version>.exe

Create new BVQ database incl. corresponding schema

BVQ DB Schema Migration

bvq-schema-migration-installer-<version>.exe

Update of an existing BVQ database (schema, tables, etc.)

BVQ GUI 64-Bit

bvq-gui-installer-x64-<version>.exe

Installation of the BVQ GUI, 64-bit

BVQ SVC Scanner

bvq-svc-scanner-installer-<version>.exe

Installation of the BVQ SVC Scanner

BVQ VMware Scannerbvq-vmware-scanner-installer-<version>.exeInstallation of the BVQ VMware Scanner

BVQ Scheduler

bvq-scheduler-installer-<version>.exe

Installation of the BVQ Schedulers

Birt Reporting 64-Bit

bvq-reporting-birt-installer-x64-<version>.exe

Installation of the BVQ Birt Reporting Engine, 64-bit

BVQ Reports

bvq-standard-reports-installer-<version>.exe

Installation of the BVQ Standard Reports

(warning) For the BVQ GUI and the reporting engine Birt the correct 32/64 bit version has to be chosen. It has to match the bit version of the operating system and Java! The Repository Installer provides only 64-bit installation files.
The 32-bit version can be found in the download section.
 

Installation module 32-bit

Installation file

Description

BVQ GUI 32-Bit

bvq-gui-installer-<version>.exe

Installation of the BVQ GUI, 32-bit

Birt Reporting-32 Bit

bvq-reporting-birt-installer-<version>.exe

Installation of the BVQ Birt Reporting Engine, 32-bit

 


Creation of BVQ database user

A BVQ DB user account has to be created in the Windows User Account Management for the DB2 authentication.
(warning) If a domain login is used, then the BVQ database user has only to be created on the Active Directory server. For more information Please see: User managed by active directory.
Standard values for BVQ DB user:

Attribute

Value

Name

bvq

Full name

BVQ Application User

Password

bvq (not mandatory)

Must change password

No

User cannot change password

Yes

Password never expires

Yes

Account is disabled

No

Groups

DB2ADMNS


Step 1: Start of the BVQ Common Installer - consolidated installer


(warning) For installation of BVQ a user with local administrative rights is required!

Execute the BVQ installation file bvq-package-repository-installer-<version>.exe with "Run as administrator".



1. Click 'Next'.

 

 

2. Choose the BVQ modules to install. Click 'Next'.

(warning) 'DB setup' has to be chosen for a new installation. If only an update is performed it should be unselected.

 

3. Click 'Next'.

 

4. Enter the installation path. By default the path is %ProgramFiles%\SVA\BVQ.
The log and config directories are located by default in %PrograData%\SVA\BVQ. Click 'Next'.

 

5. Enter the appropriate BVQ database host (BVQ DB Server or localhost), database name, user name & password.
Please see BVQ create database user for more detailed information. Click 'Next'.

 

 

6. Click 'Next'.

 

 

7. Enter the installation path. By default the directory is %ProgramData%\SVA\BVQ. Click 'Next'.

8. Click 'Next'.

 

9. Please enter name, password and the domain of the BVQ Windows Service user (if no domain is used, then a dot "." is entered). The service user is usually the same as the BVQ database user.    
Choose at 'include DB2 as a dependent service:' Yes, if the database and scanner are installed on the same server. Click 'Next'.     
(info) More details are decribed in the section: Setting the load sequence of services

 

10. The installation packages of the Repository Installer are copied to the server. Click 'Next' to start the installtion of packages.

 

11. The copy process of the individual installation packages is completed.

 

Step 2: BVQ DB Setup Wizard

A new BVQ Database incl. the needed database structure is created.

 

1. The BVQ database-wizard is started. Click 'Next'

 

2. Specify the drive letter of the BVQ database. Click 'Next'.

3.  Health monitor heap size specifies the buffer size for the database-system monitor
The standard value
is set to 8192 and should not be changed.
Click 'Next'.

4. Wait until the BVQ DB setup installation is complete.

Step 3: BVQ Schema Migration Setup Wizard

The BVQ Schema Migration Setup Wizard updates the schema and the tables of the BVQ database.

1. Then click 'Next'.

2. The schema-level of the database is checked and updated if necessary. If an update to a newer BVQ version is performed, the necessary SQL scripts will also be executed at this point.  

 

Step 4: BVQ GUI Setup Wizard

(warning)  The BVQ GUI must match the bit version of the operating system and the Java version!
Here the
Repository Installer uses the 64-bit installation engine. The 32-bit installation module, which must be used for 32-bit OS clients, is located in the download area.

1. Click 'Next' to start the installation.

2. Please select the shortcut setting. A shortcut can be created on the desktop. Then click 'Next'.

3. Enter the memory size of the GUI Java process. For best performance, the value should be chosen as large as possible.
The memory
should be at least 1024M (megabytes). For larger environments (more than 1000 VDisks) the value should be
increased to
2048M, otherwise performance degradation may occur. Then click 'Next'.   

 

4. Select the 'Create a Start Menu Folder' setting. With it the Windows folder-structure can be specified where BVQ is installed (Start -> Programs). Then click 'Next' 

 

5. Wait until the GUI installation is completed.

 

6. The installation of the GUI was completed successfully . Then click 'Yes' to start the BVQ GUI and to apply the license file.

 

7. The BVQ GUI is started.

 

8. The 'License validation' dialog opens, because no valid license has been installed. Select 'Yes' to add a valid license.

 

 

9. Open the folder of the license file.

10. Select it. Then click 'Open'.

11. The licensed BVQ modules are listed then. Click 'Save license'.

12. Now the import of the license file is complete. Then the GUI has to be restarted. Click 'OK'.

  • (warning) Important! Licence changes take effect just after about 2 hours or after restarting the scanner and scheduler.
  • (warning) Important! For the license upgrade from Entry Edition to Performance / Premium Edition a reinstallation of the DB is mandatory

(thumbs up) The BVQ GUI and license are successfully installed.

 

Step 5: BVQ SVC Scanner Setup Wizard

 

 

1. Click 'Next'.

2. Enter the installation path. By default the directoy %ProgramData%\SVA\BVQ\bvq-svc-scanner\.. is chosen. Click 'Next'.

 

3. Enter the number of scanner instances (SVC Cluster). Click 'Next'.   

 

4. Configuration of the SVC Scanner:

  • Scanner: Enter the cluster IP address of the SVC . Enter the forced topology scan interval (default = 120). At a value of 120 minutes, the scanner reads every 2 hours the topology objects (VDisk, MDisks, MDisk groups, etc.) of the SVC cluster.
    Enter the audit log scan interval (default = 30). Thus, the scanner checks every 30 seconds if since the last scan interval new topology objects have been created or changed on the SVC cluster .  
       

    If new entries are added, the topology scan will be started automatically
    . The IOstats file retention time interval determines the period of time for which the SVC performance files are kept on the server until they are overwritten by round-robin method.    
  • SSH authentication: select whether the connection to the SVC shall be done by using user name & private SSH key or just with user name & password.     
  • Java max heap size (in MiB): the default value of 512 MiB should be kept. Only for clusters with more than 1500 VDisks, the value should be increased gradually (765 MiB and 1024 MiB).
  • Email notification: allows to generate emails if log file entries are added. Default = OFF 

Click 'Next'.

 

 

5. Please wait until the installation is completed.

 

Step 6: BVQ VMware Scanner Setup Wizard

1. Click 'Next'.

 

2. Enter the number of VMware scanner instances. Click 'Next'.

 

3. Enter the VMware credentials, the query interval (Forced topology scan interval) and the maximum possible memory for Java .
     (info) BVQ uses VSphere API communication via HTTPS on port 443

 

Step 7: BVQ Scheduler Setup Wizard

1. Click 'Next'.

 

2. Click 'Next'.

3. Please wait until the installation is completed.

Step 8: BVQ Alerting Setup Wizard

 

1. Click 'Next'.

 

2. Click 'Next'.

 

3. Please wait until the installation is completed.

Step 9: BVQ Reporting Setup Wizard

(warning)  The BVQ Reporting Engine has to match the bit version of the operating system and the Java version!
Here the
Repository Installer uses the 64-bit installation engine. The 32-bit installation module, which must be used for 32-bit OS clients, is located in the download area.


 

1. Click 'Next'.

 

2. Select the shortcut setting. A shortcut can be created on the desktop. Then click 'Next'.

 

3. Keep the default heap size of 1024MiB. Then click 'Next'.    

 

 

4. Select the 'Create a Start Menu Folder' setting. With it the Windows folder-structure can be specified where BVQ is installed (Start -> Programs). Then click 'Next'  

                

 

 

5. Wait until the installation is completed.

Step 10: BVQ Standard reports Setup Wizard

1. Click 'Next'.

 

2. Wait until the installation is completed.

 

(thumbs up) The BVQ installation is now finished.

 

Setting the load sequence of services

The installation procedure asks, whether the BVQ Database runs as a service on the same server on which the scanner/scheduler is running (local). This helps to specify the correct sequencing of the services-starts, for example, after a server reboot. If both services are running on different servers,  this dependency has to be suppressed and therefore the corresponding installer-question has to be answered with 'No'.      .

Note

If the DB is not installed locally and the dependency is entered anyway, this cannot be recognized in the service-properties (Manage-> Services->BVQ-scanner->Dependencies). Dependencies are not shown, because the DB Service doesn´t even exist. For this reason a correction is not possible at this point. The BVQ Service has to be uninstalled and after the dependency was removed the service has to be reconfigured and installed again.