...

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 core-installer bundles the installers for each individual BVQ module into one installation package.

Panel

borderColor	#A1154C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#A1154C
borderStyle	solid
title	Modify your Config

Please note that changes to your existing BVQ configuration can only be made, using an update installation. This works even with the same installation file used in your current BVQ installation.

You have a running BVQ and want to change the java heap size of your BVQ Server?
Reinstall BVQ and change the specific value during the install wizard, you will keep your data, but have a different heap size value.

Procedure

The Update can be divided into 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

...

Section

Column

width	100%

Panel

borderColor	#739451
bgColor	#EFF2F2
titleColor	white
titleBGColor	#739451
borderStyle	solid
title	°

Auibutton

custom-icon	share
icon	custom
title	Install Wizard
type	subtle
url	https://bvqwiki.sva.de/display/BVQ/BVQ+Installation#BVQInstallation-InstallWizard

Panel

borderColor	#396A3B
bgColor	#EFF2F2
titleColor	white
titleBGColor	#396A3B
borderStyle	solid
title	°

Auibutton

custom-icon	task-list
icon	custom
title	Maintenance
type	subtle
url	BVQ Update Whitepaper#Maintenance

Panel

borderColor	#529FC1
bgColor	#EFF2F2
titleColor	white
titleBGColor	#529FC1
borderStyle	solid
title	°

Auibutton

custom-icon	credit-card-filled
icon	custom
title	Grafana
type	subtle
url	https://bvqwiki.sva.de/display/BVQ/BVQ+Installation#BVQInstallation-Grafana

Image Modified

Section

Column

width	100%

Panel

borderColor	#A1154C
bgColor	#DADBE7
titleColor	white
borderWidth	3
titleBGColor	#A1154C
borderStyle	solid
title	Install Wizard

Anchor

	Install Wizard
	Install Wizard

Section

Column

width	100%

Panel

borderColor	#A1154C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#A1154C
borderStyle	solid
title	Start the installation

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

Welcome to the BVQ installer, the 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

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#A1154C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#A1154C
borderStyle	solid
title	Select Components

For updates, it's necessary to select all of the BVQ components.

Please note: Deselecting components in an existing installation will remove the deselected components during the installation process.
This can potentially result in loss of data or functionality, which may have serious consequences.
Ensure that you have backed up all necessary data before proceeding.

-Click 'Next' to advance to the next page

Expand

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#A1154C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#A1154C
borderStyle	solid
title	Select 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

title	expand...

Image Modified

Section

Column

width	100%

Anchor

	Credentials
	Credentials

Panel

borderColor	#A1154C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#A1154C
borderStyle	solid
title	Database

Your 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

title	expand...

Image Modified

Excerpt

Section

Column

width	100%

Panel

borderColor	#A1154C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#A1154C
borderStyle	solid
title	Web 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

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#A1154C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#A1154C
borderStyle	solid
title	Use 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.

The "Domain name" field has to be the set to the FQDN like bvqtest.labwi.sva.de

Also, the Windows user must have read access rights for the certificates.

-Click 'Next' to advance to the next page

Expand

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#A1154C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#A1154C
borderStyle	solid
title	Use 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

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#A1154C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#A1154C
borderStyle	solid
title	Windows 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

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#A1154C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#A1154C
borderStyle	solid
title	Installation

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

Expand

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#A1154C
bgColor	#DADBE7
titleColor	white
borderWidth	3
titleBGColor	#A1154C
borderStyle	solid
title	For research purposes only

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

Expand

title	expand...

Insert excerpt

	BVQ Installation Log
	BVQ Installation Log

When you encounter issues during the update, please be aware,
that the complete log 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

width	100%

Anchor

	cert
	cert

Panel

borderColor	#A1154C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#A1154C
borderStyle	solid
title	Completing the BVQ Setup Wizard

The 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

title	expand...

Image Modified

Section

Column

width	100%

Anchor

	cert
	cert

Panel

borderColor	#A1154C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#A1154C
borderStyle	solid
title	Accept 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

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#A1159B
bgColor	#DADBE7
titleColor	white
borderWidth	3
titleBGColor	#A1159B
borderStyle	solid
title	Maintenance

Anchor

	Maintenance
	Maintenance

Section

Column

width	100%

Panel

borderColor	#7C238C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#7C238C
borderStyle	solid
title	Login 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>

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

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#7C238C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#7C238C
borderStyle	solid
title	Java Version

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

Expand

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#7C238C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#7C238C
borderStyle	solid
title	Share 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

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#7C238C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#7C238C
borderStyle	solid
title	Filesystem

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

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#7C238C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#7C238C
borderStyle	solid
title	MongoDB Version

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

Expand

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#7C238C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#7C238C
borderStyle	solid
title	Maintenance 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

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#7C238C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#7C238C
borderStyle	solid
title	Web 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

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#7C238C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#7C238C
borderStyle	solid
title	BVQ 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

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#7C238C
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#7C238C
borderStyle	solid
title	Maintenance 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

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#2415A1
bgColor	#DADBE7
titleColor	white
borderWidth	3
titleBGColor	#2415A1
borderStyle	solid
title	Grafana Datasource

Excerpt

Section

Anchor

	Grafana
	Grafana

Column

width	100%

Panel

borderColor	#2415A1
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#2415A1
borderStyle	solid
title	Grafana

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

title	expand...

Image Modified Image Modified

Section

Column

width	100%

Panel

borderColor	#2415A1
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#2415A1
borderStyle	solid
title	Move to your Grafana Datasource

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

Expand

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#2415A1
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#2415A1
borderStyle	solid
title	Change the URL

The BVQ Data Source is shown and can be adjusted.

If you changed the protocol from HTTP to HTTPS during the BVQ update, you need to adjust the address accordingly.
https://FQDN

You have to edit the HTTP/URL field as well as the BVQ Settings/BVQ Server URL field on the bottom of the page.

Expand

title	expand...

Image Modified

Section

Column

width	100%

Panel

borderColor	#2415A1
bgColor	white
titleColor	white
borderWidth	3
titleBGColor	#2415A1
borderStyle	solid
title	Add a Certificate

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

title	expand...

Image Modified

Version	Old Version 11	New Version 12
Changes made by	Dominik Karch	Dominik Karch
Saved on	28.09.23	09.10.23

Content Comparison

Versions Compared

Key

Introduction

Procedure