...
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 all-new core-installer is a .exe file which should be placed on either the host which is currently running BVQ or on the host which is supposed to run BVQ.
Information about the requirements are placed here and before installing BVQ for the first time we strongly recommend to read also the preparations article out of the Getting Started Guide.
The core-installer bundles the installers for each individual BVQ module into one installation package.
Common configuration parameters, such as DB access data, user and directories have default values which are recommended.
Our suggestion is to use a local Windows user, to set up the services with.
Panel | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
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? |
Procedure
The initial setup can be divided into 7 subsequent stages:
...
have |
...
Section | |||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Column | | ||||||||||||||||||||||||||
| |||||||||||||||||||||||||||
Panel | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||
Anchor | Install Wizard | Install Wizard | |||||||||||||||||||||||||
Section | |||||||||||||||||||||||||||
Column | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||
Panel | |||||||||||||||||||||||||||
|
Expand | ||
---|---|---|
| ||
Section | |||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
width | 100% |
---|
borderColor | #A1154C |
---|---|
bgColor | white |
titleColor | white |
borderWidth | 3 |
titleBGColor | #A1154C |
borderStyle | solid |
title | Select Components |
Only if you want to run multiple BVQ installations or would like to run each component on a different host, the deselection of components is required.
-Click 'Next' to advance to the next page
Expand | ||
---|---|---|
| ||
width | 100% |
---|
borderColor | #A1154C |
---|---|
bgColor | white |
titleColor | white |
borderWidth | 3 |
titleBGColor | #A1154C |
borderStyle | solid |
title | Select Destination Directory |
Select the directories in which you would like to install BVQ, the directories cannot be changed afterwards.
As the default values suggest, the data and log folders are not to be placed in the same directory.
a
second drive to place the data and log folders, as the amount of data placed in these folders will increase in time.-Click 'Next' to advance to the next page
Expand | ||
---|---|---|
| ||
width | 100% |
---|
borderColor | #A1154C |
---|---|
bgColor | white |
titleColor | white |
borderWidth | 3 |
titleBGColor | #A1154C |
borderStyle | solid |
title | Database |
The "Database server access" values are used by BVQ for the internal communication between the database and the BVQ Server, hence these values are recommended.
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 will be your BVQ-credentials,which you will use to access your BVQ, as well as the credentials, BVQ uses to connect to the database.
If you need to define different passwords for the internal database and your specific BVQ access, this task must be performed separately after installation,
please keep in mind that you are still able to create different BVQ users with
different
passwords, when the installation is completed.If you choose to change these values, saving the credentials in a password safe will be self-evident.However, the default values which are pictured below will be used to log in to your Grafana, here
-Click 'Next' to advance to the next page
Expand | ||
---|---|---|
| ||
width | 100% |
---|
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.
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.
title | expand... |
---|
Section | |||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
width | 100% |
---|
borderColor | #A1154C |
---|---|
bgColor | white |
titleColor | white |
borderWidth | 3 |
titleBGColor | #A1154C |
borderStyle | solid |
title | Use own-certificate |
If it is encrypted, 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 | ||
---|---|---|
| ||
width | 100% |
---|
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.
-Click 'Install' to advance to installation
Expand | ||
---|---|---|
| ||
Section | |||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
width | 100% |
---|
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:
.
...
width | 100% |
---|
...
borderColor | #A1154C |
---|---|
bgColor | white |
titleColor | white |
borderWidth | 3 |
titleBGColor | #A1154C |
borderStyle | solid |
title | Completing the BVQ Setup Wizard |
The installation has been successful.
...
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 | ||
---|---|---|
| ||
...
width | 100% |
---|
...
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.
...
title | expand... |
---|
...