Versions Compared

Key

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

...

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.

...

Panel
borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleModify 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.

Install Wizard

Procedure

The initial setup can be divided into 7 subsequent stages:

...




BVQ

...

Installation

...

Prepare System
Image Removed
Image Removed
Image Removed
Image Removed
Image Removed
Image Removed

Image Removed

...

width100%

...

borderColor#A1154C
bgColor#DADBE7
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleInstall Wizard

...

width100%

...

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 installation.
Open the core-installer.

...

-Click 'Next' to advance to the next page

Expand
titleexpand...
Image Removed
Section
Column
width100%
Panel
borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleInformation

Our BVQ readme

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

Expand
titleexpand...
Image Removed

...

width100%

...

borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleSelect Components

...

-Click 'Next' to advance to the next page

Expand
titleexpand...
Image Removed
Section
Column
width100%
Panel
borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleSelect 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.

You may choose to use 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
titleexpand...
Image Removed

...

width100%

...

borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleDatabase

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.

...

-Click 'Next' to advance to the next page

Expand
titleexpand...
Image Removed

...

width100%

...

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. 

...

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.

...

titleexpand...

Image Removed

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...
Image Removed

...

width100%

...

borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleUse own-certificate

...

-Click 'Next' to advance to the next page

Expand
titleexpand...
Image Removed

...

width100%

...

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.

...

-Click 'Install' to advance to installation

Expand
titleexpand...

Image Removed

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...
Image Removed

...

width100%

...

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:

...

titleexpand...

...

width100%

...

borderColor#A1154C
bgColorwhite
titleColorwhite
borderWidth3
titleBGColor#A1154C
borderStylesolid
titleCompleting 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
titleexpand...

Image Removed

...

width100%

...

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.

...

titleexpand...

...