Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.




Introduction

Our customers are notified by mail about each new BVQ version, this includes a download link to the newest BVQ.
BVQ updates and first-time installations follow the same workflow.

...

The Update can be divided into 4 3 subsequent stages:


  • Installation wizard which guides you through the setup
  • Maintenance page where BVQ is checking the environment and its own files
  • Grafana data sources must be adjusted after each port change or implementation of a new HTTPS certificate
  • BVQ GUI is an extensive tool, with which you are able to have direct access to your data








Image Removed



...



Section
Column
width100%
Panel
borderColor#A1154C
bgColor#DADBE7
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleInstall Wizard

Anchor
Install Wizard
Install Wizard


Section
Column
width100%
Panel
borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleStart the installation

After placing the core-installer on the specific host you are ready to start the installationupdate.
Open the core-installer.


Welcome to the BVQ installer, the installation update is about to begin shortly.
As you can see the installer has identified your current BVQ installation and is about to update the running BVQ.

-Click 'Next' to advance to the next page

Expand
titleexpand...
Section
Column
width100%
Panel
borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleSelect Components

For updates it is necessary to choose all of the BVQ components.


-Click 'Next' to advance to the next page

Expand
titleexpand...
Section
Column
width100%
Panel
borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleSelect Destination Directory

The "Database server access" values are used by BVQ for the internal communication between the database and the BVQ Server.

The Database name will be the name of the internal database, residing on the MongoDB-server.

For the User authentication fields, it is important to understand that these credentials are your BVQ database -credentials,
which BVQ uses to connect to the database.

-Click 'Next' to advance to the next page

Expand
titleexpand...
Section
Column
width100%

Anchor
Credentials
Credentials

Panel
borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleDatabase

Your default current port number will be displayed.
Keep in mind that the port number varies according to the selected transfer protocol option.
The default port for a server which will be accessible via HTTP is 80, the default port for the activated HTTPS option is 443.
For example, if you change the port number to 8080 and choose "enable HTTPS" afterwards, the port number will be changed to the default value 443.
Also please be aware that for every BVQ port change, you have to adjust the Grafana datasource. 


Grafana configuration is the Grafana port, which will be used by the BVQ installed Grafana.

The heap sizes are configured for both the BVQ Server which will run as a Webserver and the scanner service which will collect the data of the systems you will be scanning.
If the number of scanners will increase considerably in the future, the specific values can be adjusted accordingly.
BVQ Server max heap size = 4096 MB is recommended (depending on the environment).
BVQ Scanner max heap size = 1024MB is recommended (depending on the environment).


Select HTTPS to be enabled if you choose to.

Expand
titleexpand...
Excerpt
Section
Column
width100%
Panel
borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleWeb server

The port number under which BVQ will be accessible varies according to the selected transfer protocol option.
The default port for a server which will be accessible via HTTP is 80, the default port for the activated HTTPS option is 443.
For example, if you change the port number to 8080 and choose "enable HTTPS" afterwards, the port number will be changed to the default value 443.
Also please be aware that for every BVQ port change, you have to adjust the Grafana datasource. 

Anchor
Grafanaconfig
Grafanaconfig

Report TTL: The reports you run in the future are available as a default, for 30 days.

Grafana configuration is the Grafana port, which will be used by the BVQ installed Grafana.

The heap sizes are configured for both the BVQ Server which will run as a Webserver and the scanner service which will collect the data of the systems you will be scanning.
If the number of scanners will increase considerably in the future, the specific values can be adjusted accordingly.
BVQ Server max heap size = 4096 MB is recommended (depending on the environment).
BVQ Scanner max heap size = 1024MB is recommended (depending on the environment).


Select HTTPS to be enabled if you choose to.

Expand
titleexpand...


Section
Column
width100%
Panel
borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleUse self-signed certificate

By enabling HTTPS and the use of a self-signed certificate, BVQ will create a certificate for you.
The Keystore password has a default value, which can be adjusted,
any of the following values must be set to continue..

-Click 'Next' to advance to the next page

Expand
titleexpand...
Section
Column
width100%
Panel
borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleUse own-certificate

By enabling HTTPS and the use of an own-certificate, you must "browse" the location of your private and public key,
and enter the specific password for the key.

The Keystore password has a default value, which can be adjusted,

-Click 'Next' to advance to the next page

Expand
titleexpand...
Section
Column
width100%
Panel
borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleWindows service configuration

To create and start the BVQ services an authorized Windows user is required.
In case of possible vm reboots in the future, a local user is recommended to be used.
For the use of a local user, the domain field must be empty.

The given credentials will only be used for this specific step.

-Click 'Install' to advance to installation

Expand
titleexpand...

Section
Column
width100%
Panel
borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleInstallation

The installation starts and the current processes are displayed from top to bottom

Expand
titleexpand...
Section
Column
width100%
Panel
borderColor#A1154C
bgColor#DADBE7
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleFor research purposes only

When the installation of BVQ is completed, you can find the installation log here:

Expand
titleexpand...

Insert excerpt
BVQ Installation Log
BVQ Installation Log




When you encounter issues during the update, please be aware,
that the complete log of the installation is only visible, as long as the installation wizard is active
and the log can be found in the AppData directory, the name of the log file will be:
i4j_log_bvq-core_<hash-code>.log


And it will be placed here:
C:\Users\<windows_user>\AppData\Local\Temp

Section
Column
width100%

Anchor
cert
cert

Panel
borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleCompleting the BVQ Setup Wizard

The installation update has been successful.

You can choose to start the BVQ WebUI after finishing the wizard, which is enabled by default.
Displayed is also the BVQ Web address as well as the Grafana address.

The next steps will be to access the BVQ WebUI to complete the maintenance which is active after every update or installation
and if you have chosen a HTTPS installation, the Grafana-Datasource has yet to be adjusted.

After using the 'Finish' -Button, the wizard will be closed and your default browser will open, directing you to the localhost webpage
Please keep in mind, that the start of the BVQ services could take a minute

Thank you for using a supported browser, such as:
"Firefox, Chrome, Safari, Edge"

Expand
titleexpand...

Section
Column
width100%

Anchor
cert
cert

Panel
borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleAccept the Certificate

The localhost webpage has opened up,
if you created your own certificate during the installation of BVQ, an exception is necessary, to continue to the BVQ webpage.

Expand
titleexpand...




...

Section
Column
width100%
Panel
borderColor#A1159B
bgColor#DADBE7
titleColorwhite
borderWidth3
titleBGColor#A1159B
borderStylesolid
titleMaintenance

Anchor
Maintenance
Maintenance

Section
Column
width100%
Panel
borderColor#7C238C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#7C238C
borderStylesolid
titleLogin to your BVQ maintenance

Open a supported browser and use the following (HTTP or HTTPS):

http://localhost/#/ui/login for the BVQ Maintenance Mode
or
http://localhost/ui/login for the BVQ Web Server
On any other client in the network, you can use a browser and type: http://<BVQ-ServernameOrIP>

To Access the BVQ-Maintenance-Page please use the credentials, created during the installation, here


We do also provide a selection of the supported browsers as well as the specific links.


TheBVQmaintenancepagethatyouwillberedirectedtoaftereachupdateand installation, is thelaststepforBVQtocheckandconfirmspecific configurations.
Only checks that require values or actions will be displayed.

When you have completed the last step, of your maintenance, you will be shown a "Maintenance completed successfully" window, the services of BVQ will be restarted and your are directed to the BVQ webpage.

Expand
titleexpand...


Section
Column
width100%
Panel
borderColor#7C238C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#7C238C
borderStylesolid
titleJava Version

BVQ checks the installed Java version of your system, if the current version is suitable to run BVQ.

Expand
titleexpand...

Section
Column
width100%
Panel
borderColor#7C238C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#7C238C
borderStylesolid
titleShare Usage Statistics

Our aim is to give our customers the best possible BVQ experience, we want to understand how we can serve you better.
We would recommend you to help us, by sending the statistics.

Expand
titleexpand...

Section
Column
width100%
Panel
borderColor#7C238C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#7C238C
borderStylesolid
titleFilesystem

BVQ will check the BVQ folders on your filesystem, to confirm that the placed files are in order.
If you are updating a running BVQ, its going to take more time, the bigger the database.

Expand
titleexpand...

Section
Column
width100%
Panel
borderColor#7C238C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#7C238C
borderStylesolid
titleMongoDB Version

The database server used by BVQ is a MongoDB, this check confirms that the used version is corresponding.

Expand
titleexpand...

Section
Column
width100%
Panel
borderColor#7C238C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#7C238C
borderStylesolid
titleMaintenance Page

BVQ database structures do change by version, so that the running database schema may have to be adjusted.
If your database schema has to be adjusted, BVQ will ask you to "Start DB schema adjustments".
The duration of this task varies according to the size of your database, most adjustments take less than 15 minutes.

Expand
titleexpand...

Section
Column
width100%
Panel
borderColor#7C238C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#7C238C
borderStylesolid
titleWeb Server Base URL

With the correct firewall configuration, you are able to reach your BVQ webserver from all over your network.
BVQ is able to send notifications to users and machines, to clearly state from which host these notifications are coming from we need you to add the host address.

Expand
titleexpand...

Section
Column
width100%
Panel
borderColor#7C238C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#7C238C
borderStylesolid
titleBVQ License

During an initial installation or when your license is no longer valid, you have to choose to activate a trial license or upload a valid license.
The trial license is for a period of six weeks, after which the BVQ will no longer collect data.

Expand
titleexpand...

Section
Column
width100%
Panel
borderColor#7C238C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#7C238C
borderStylesolid
titleMaintenance completed

Due to the fact that every necessary action has been performed, you have completed the maintenance and are redirected to the BVQ webpage shortly.

Expand
titleexpand...

...

Section
Column
width100%
Panel
borderColor#2415A1
bgColor#DADBE7
titleColorwhite
borderWidth3
titleBGColor#2415A1
borderStylesolid
titleGrafana Datasource
Excerpt
Section

Anchor
Grafana
Grafana

Column
width100%
Panel
borderColor#2415A1
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#2415A1
borderStylesolid
titleGrafana

For each update where you have created a new HTTPS certificate, you must adjust the BVQ datasource within the Grafana.

Additionally for each update where you have changed the port number for the BVQ server, you have also to adjust the BVQ datasource within the Grafana.


Open your Grafana with the Grafana button, a new tab will open up and login to Grafana using the default BVQ-Credentials, here

Expand
titleexpand...

     

Section
Column
width100%
Panel
borderColor#2415A1
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#2415A1
borderStylesolid
titleMove to your Grafana Datasource

Open the Configuration menu and click on Data source,
the installed Data source plugins are listed,
click on BVQServer to move to the specific Data source.

Expand
titleexpand...



Section
Column
width100%
Panel
borderColor#2415A1
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#2415A1
borderStylesolid
titleChange the Port Number

The BVQ Data Source is shown and can be adjusted.

If you changed the port number of the BVQ server during the BVQ installation, you need to adjust the port number accordingly.


Click on "Safe & Test" to adjust the data source.

Expand
titleexpand...




Section
Column
width100%
Panel
borderColor#2415A1
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#2415A1
borderStylesolid
titleAdd a Certificate

The BVQ Data Source is shown and can be adjusted.

For adding the certificate,
you only need to activate "With CA Cert"
and paste the certificate text to "CA Cert", shown here
(You can also find the self-signed certificate by default here: C:\Program Files\SVA\BVQ\bvq-core\cert)


Click on "Safe & Test" to adjust the data source.

Expand
titleexpand...



Image Removed

Section

If your connection is not established, you may need to modify the connection profile, which is used to connect to the database.
You can edit your current profile with the correct values, you can also add a connection profile.
There is also the easy option to open a already downloaded profile (BDPM File).

Image RemovedImage Removed

Image Removed

With an established connection and selected systems, you are ready to to click "Start" to load data.
Depending on your connection and the amount of loaded data, the BVQ GUI will load for a few minutes.

Image Removed

Image Removed

Your BVQ GUI is ready for use and you can get started right away.

Image Removed

Create your own view by arranging a Path.
Followed by selecting specific objects, by using the Columns tab under the Tree table.

Each Master Grouping Object you choose to add, to the Path will unlock new objects selectable in the Columns.
Every object you select in the Columns will appear as a new column in your Main Window view.

Image Removed

Image Removed

Image Removed
Column
width100%
Choose the directory for the installation of your BVQ GUI.
You also have to select the heap size of the BVQ GUI, which has a default value of 4096MiB.

Memory usage limit (MiB)
Is equal to the maximum heap size of the Java environment.

Recommendation:
The default value should suffice, if you notice that the program slows down over a period of time,
increase this value to prevent poor performance and application failures.
A memory utilization gauge is available on the BVQ GUI main menu below "?".

-Click 'Install' to advance to installation

Panel
borderColor#160D64
bgColor#DADBE7
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleBVQ GUI
Excerpt
Section
Column
width100%
Anchor
BDPMfileBDPMfile
Panel
borderColor#160D64
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleDownload your GUI

The BVQ GUI is an application, which connects to your BVQ database and gives you the freedom to browse through your collected data.
When you completed the installation, the BVQ GUI installer is by default located in the following directory:

Code Block
themeMidnight
C:\Program Files\SVA\BVQ\bvq-core\bvq-server\gui

You can download the BVQ GUI installer on every client, that can reach the BVQ Web Server.
Please be aware that the BVQ GUI installer is for Windows only.

Expand
titleexpand...

Image Removed

The third option for downloading the install file is to move to your "Server information", which is located under the Support tab.
You will find 4 available tabs, the download button is located under "Database".
The BDPM-File is the prefilled connection profile which enables the  BVQ GUI to connect to a specific BVQ database.

Expand
titleexpand...

Image Removed

Section
Column
width100%
Panel
borderColor#160D64
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleGUI Setup Wizard

After opening the install file,  your GUI Setup Wizard will start.

-Click 'Next' to advance to the next page

Expand
titleexpand...

Image Removed

Section
Column
width100%
Panel
borderColor#160D64
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleGUI Information

Our BVQ readme

-Read all the information carefully and click 'Next' to advance to the next page

Expand
titleexpand...

Image Removed

Section
Column
width100%
Panel
borderColor#160D64
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleStart Menu Folder

You have the option to create shortcuts in a Start Menu folder, as well as to create them for all users.

-Click 'Next' to advance to the next page

Expand
titleexpand...

Image Removed

Section
Column
width100%
Panel
borderColor#160D64
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleInstallation Parameters
Expand
titleexpand...

Image Removed

Section
Column
width100%
Panel
borderColor#160D64
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleInstalling

The installation starts and the current processes are displayed from top to bottom

Expand
titleexpand...

Image Removed

Section
Column
width100%
Panel
borderColor#160D64
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleCompleting the BVQ GUI Setup

The installation has been successful.
You can choose to start the BVQ GUI after finishing the wizard.

-Click 'Finish' to close the installer and start the BVQ GUI  if selected.

Expand
titleexpand...

Image Removed

Section
Column
width100%
Panel
borderColor#160D64
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleBVQ is Starting

Your BVQ GUI is starting now

Expand
titleexpand...

Image Removed

Your BVQ GUI immediately connects to your database,
which is indicated by the connection bar below.
When successfully connected, not only a green check mark appears below,
the number of the systems is now visible.
You can select specific systems by clicking on system categories (SAN, Storage, etc.) or choose All or None,
It is prudent to choose only the systems you wish to check, to reduce the amount of data that will be transferred.
Section
Column
width100%
Panel
borderColor#160D64
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleDatabase Connection
Expand
titleexpand...

Image Removed

Image Removed

Image Removed

Section
Column
width100%
Panel
borderColor#160D64
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleConnection Profile
Expand
titleexpand...
Section
Column
width100%
Panel
borderColor#160D64
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleLoad Data
Expand
titleexpand...
Section
Column
width100%
Panel
borderColor#160D64
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleReady to Analyze
Expand
titleexpand...
Section
Column
width100%
Panel
borderColor#160D64
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleGet Familiar
Expand
titleexpand...
Section
Column
width100%
Panel
borderColor#160D64
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#160D64
borderStylesolid
titleUse Favorites

Make use of our Favorites and customize them to your liking,
safe them in your User folder.

Expand
titleexpand...

Image Removed
Image Removed