click to expand ...

Home
About SVA ... Contact us
Overview (all documents)
Product description
Services with BVQ
BVQ advantages
New functions and future plans
White papers
Downloads and releases
Users Manual and users guide
Further WIKI documents
BVQ V5.3.3 released Minor bugfix release

 


Download

 

Recent Version

 


Versions

VersionReleasedInstall Packages
5.3.301.12.2017All in oneGUI
5.3.224.10.2017  
5.3.106.09.2017  
5.3.021.08.2017  

 

 

 

 

 

 


 

Table of content

 

DB2 to MongoDB Migration

This release does not support a direct upgrade from DB2 based BVQ Installations. To upgrade such, take a look at the migration guide and contact our BVQ support team up front please.

Go to the DB2 to Mongo DB migration guide!

Important

Some fixes during the installation process require some important preconditions:

  1. Make sure you do the update with the same Windows User you used during the last installation
  2. Verify that the service-user is inside the Administrator Group

Data Migration

The update contains multiple data migrations inside BVQ which might result in a long running migration process. This affects especially systems with a lot of Storwize Systems.

  1. Multiple fixes inside the topology history
  2. Repair interchanged drive metrics (Storwize Systems)
  3. Improved index structure

Highlights

Path based charting

Since BVQ Version 5.0 it is possible to display a table (Treetable) below the Treemap. Now we went one step further and extended the Topology view with the option to add a performance chart to interact with the objects visible in Treemap or Treetable. This enhances the possibilities to select and restrict objects based on dynamic filters and selected conditions. Now there are three views available to be displayed in the Toplology view: Treemap, Treetable and Chart. Currently you can display two of them simultaneously in ever combination.

One of the most useful extensions with this feature is the possibility to show multiple aggregated metrics. Aggregated metrics are always calculated based on the objects visible in the Treemap or Treetable. In combination with the new Enhanced Filtering the views can be made highly dynamic and reusable as favorites for specific use cases.
To manage the objects visible in the chart a Chart visibility Context menu was added for Treemap and Treetable objects.

 

Usage example:

 

Null object

The validity of information a BVQ or SVC object can provide is highly dependent on relations to other objects in many situations. The BVQ path browser reflects these relationships since the beginning but was only capable of displaying objects that fulfill all relations. The NULL Object is able to soften this restrictions and provide a way to display objects that don't meet all requirements. This is really useful to find objects that aren't configured correctly or aren't accessible through a usual path. The Null Object is always displayed as undef.

Examples:

  • Show all MDisks that are not part of an MDisk Group
  • Group objects without a site or room

Example: Hosts grouped by Room and Site

All Hosts that aren't assigned to any room are grouped in a Site undef. and Room undef. None of them has been visible in previous versions.

Enhanced filtering

Since version 5.0 it is possible to use basic filter options inside the Topology View. This type of filter was restricted to direct object attributes which could be connected with AND conditions.
The new enhanced filtering added a lot of additional filter options to specify filters that exactly fit your needs even if they are highly complex.

Features:

  • Compare different object attributes with each other
  • Compare object attributes with context attributes (subelementcount, subelementsize, etc)
  • Concatenate with AND, OR, NOT, XOR
  • Graphical editor to support condition creation
  • Selective enable/disable filter conditions

Example:
How to filter Clusters and MDisk groups that contain VDisks with a virtual capacity greater than 500GiB or with more than 500 IO/s in average the last day


Integrated Help


Video Introduction


Web dashboard

The BVQA Web Dashboard is based on Grafana, which is one of the leading open source software tools to visualize time series data that can interact with different data sources (https://grafana.com/).
The BVQ Server now provides an API to access most performance metrics you know from the BVQ GUI, to visualize them in Grafana. Therefore, you have the option to install a preconfigured Grafana with some default Dashboards inside the BVQ Server. This offers a great possibility to view general "realtime" information directly in the browser without the need to open the BVQ GUI.

 

In the first release of BVQ Grafana it is not possible to create or change dashboards. This feature will be added in a future release.

 

REST API

Microsoft Excel is the most important and flexible Reporting Tool. Manifold opportunities to create tables, charts, calculations, etc. bundled with a variety of different skills makes it useful in a lot of different situations. Excel provides a wide range of options to import data from different formats in files, databases or API's.

BVQ now provides an API to connect Excel to Topology information based on favorites located in "All Users". The information can be displayed in a Treetable and imported into Excel for further processing.

Use cases:

  • Asset management
  • Controlling
  • Enrichment with additional data
  • Report exchange

To access and explore the API endpoints, the BVQ-Server provides an overview page to display the required URL and all information connected to the favorite.

Reporting → Data sources

 

Capacity format

All capacity information is provided in byte format. Excel will display them in exponential format so you have to format them for a better visualization.

 

Although the API is promoted with Excel it is also possible to connect other systems

 

New Scanner module

The scanner module has been revised completely to simplify adding, updating and changing settings for individual scanner and support more systems to be scanned. Therefore the scanner has been moved into one dedicated service that will perform the work for multiple systems with less resource utilization.

The "old" scanner method (seperate scanner modules for SVC and VMware) will be removed in BVQ version 5.5

 

To manage the scanner the BVQ-Server provides an easy to use Web UI.

 

Settings for VMware and SVC scanner vary in some details but are comparable to the known settings from previous BVQ scanner.

 

To show the log files for a scanner, click the blue "log icon" in the overview page. The logs will be presented in 1h buckets with additional coloring for WARN and ERROR messages.

 

Scanner Migration Guide

If you are planning to migrate your existing scanners to the new scanner module, please take a look into the Scanner Migration Guide!

 

All way pathing

You are now able to combine all objects in a meaningful path. This is enabled by using graphs internally.

 

Favorite-menu

In the last BVQ Releases favorites became more and more important. To make them accessible more easily, we added a "Favorites"-option directly to the BVQ Main menu. All previous methods to open a favorite are still available.

Additionally, we removed the old obsolete Table View menu and added a Table view section to the system favorites. They are now enriched with a lot of additional meaningful content and supported with documentation and links to further information.

Thin coverage ratio

New attribute "Coverage %" shows the ratio of over-allocated thin capacity covered by a pool or cluster. You can set an alert on it to be warned before you run out of space due to thin space allocation eating up all your free space.

In the example above, thin provisioned volumes could potentially fill unused 60TB, but this is only covered by 30TB of free space in the providing pools. Thus the coverage ratio is only 50%. Coverage ratio is available in object types aggregating MDisk groups (Pools) like Storage classes, Mobility zones and in such aggregating VDisks like Hosts, VDisk groups, or Applications.

Retrospective tabular reports

Enables you to create a tabular report on a past point in time.

 

 

 


 

Requirements and restrictions 

Requirements of the HW/SW environment

Please see Supported Environments

Minimum BVQ version required for an update

V5.0.1 (with Data Migration )

V5.1.0 (without Data Migration)

Recommended Java Runtime version

1.8.0.151 64bit

Known Issues

See https://customercenter.sva.de/home/x/NwwgAw
(support agreement needed to get access credentials)

 

Update from a previous MongoDB Installation step by step 

Important update notes

  1. BVQ license: A new license file may be required to use some of the new features.
  2. GUI favorites:  During some of the GUI updates the predefined favorites are replaced. Possible user changes will be lost. However, changes in user favorites and all user favorites are kept.
  3. If you have problems: Please contact your BVQ support partner


  1. Preparation
    • Check that the   environment is working properly, in particular the scanners.
    • Manually stop BVQ Scanner and Alerting-service, Scheduler-services and also of all GUIs and reporting-clients
    • Backup the BVQ installation directory and BVQ DB (e.g. DB backup with mongodump, VMware snapshots) 
    • Start again the BVQ Scanner
  2. Update BVQ Install Package Repository: bvq-package-repository-installer-x64-V5.3(.x).exe
    1. DB Schema update
    2. BVQ GUI update
    3. BVQ Server update
    4. BVQ SVC Scanner update 
    5. BVQ VMware Scanner update
    6. BVQ Scheduler update
    7. BVQ Alerting update
  3. Perform functional tests
  4. If necessary inform colleagues about the need to update locally installed BVQ GUI clients.  

 

Changelogs

 Version 5.3

Version 5.3

New features

Issue ID

Module

Description

BVQ-6039

GUI

Path integrated charting: Group multiple aggregation curves according to path

BVQ-12146

GUI: Topology view

Enhanced filtering

BVQ-3627

GUI: Topology view + Reporting

Show unassigned objects within a "NULL" container

BVQ-11746ReportingReporting interface for Microsoft Excel datasources
BVQ-11879Server: GrafanaUse Grafana as a Web based user interface to visualize BVQ performance metrics (v1)
BVQ-11750ScannerConsolidate scanner instances into a single service

BVQ-12157

GUIAttributes: Add overprovisioned capacity coverage %
BVQ-11865GUI: Topology viewBe able to combine all objects with each other in a path (switch to object type relations based on graphs)

 

Improvements

Issue ID

Module

Description

BVQ-11560

Scheduler

Drop calculation for T0 Performance Indicators and integrate dynamic loading

BVQ-12206

GUI

Context Menu: Optimize Isolate Menu

BVQ-10920

GUI

Attributes: Controller: Show queue depth in Controller Port and Controller

BVQ-12426

GUI: Favorites

Allow change for start view flag for system favorites

BVQ-12282

GUI: Editor

VDisk group relation: Preselect VDisk group if called from its editor

BVQ-11315

GUI: Multi viewTry to copy selection to Topology-View

BVQ-12188

GUI: Multi viewOpen detail pane blocks CTRL+SHIFT+R to come through

BVQ-12033

GUI: Performance viewOptions: Timing: Time favo button should have a label

BVQ-10509

GUI: Topology viewAdd MDisk tier coloring to coloring tooltip

BVQ-11520

GUI: Table viewAspect Capacity Utilization: Add special attributes for free space and ratio
BVQ-11679GUI: Table viewEnrich inital default table config and make it customizeable

BVQ-12076

CommonSVC 7.8.1: Add new copy and clean rates
BVQ-7790CommonEncrypt passwords for all modules in all registry and properties values
 Server, DBA lot of important performance improvements


Bug fixes

 

Issue ID

Module

Description

CriticalBVQ-12253DBHistory corrupted by history migration and Scanner persists running in parallel
CriticalBVQ-12254DBHistory corrupted by missing migration of "vdisk_copy_hist"
CriticalBVQ-12288GUIMulti Views: Window change flag missing
ImportantBVQ-12429

Scanner

Error on "Email Error Notification" without smtp credentials
ImportantBVQ-12099

GUI: Favorites 

"Link controllers to rooms" does not show all assigend Rooms
ImportantBVQ-12268

GUI

Managing VDisk groups leads to duplicate history entries
ImportantBVQ-12084

GUI

Performance View: NPE when trying to change scale of y-axis
ImportantBVQ-12327

DB

Some deleted CMDGs not marked as deleted in history collection
MinorBVQ-11192GUIDetail Pane: Wrong IP port handling for svc_node_port
MinorBVQ-11950GUIEvent Table / Performance View: BVQRuntimeException & NullPointerException when trying to show events
MinorBVQ-12198GUI: FavoritesRename folder does not refresh folder tree
MinorBVQ-12032GUI: Performance ViewOptions: Timing: Reset timing to default causes exception
MinorBVQ-12279CommonMissing line break in properties files
 Version 5.3.1

Version 5.3.1

New features

Issue ID

Module

Description

BVQ-12357

GUI: Favorite

Add Favorites to main menu

 

Improvements

Issue ID

Module

Description

BVQ-12446

Installer

Allow MongoDB cache size < 4GB

BVQ-12521

Scanner

Resolve interruption of performance scan if 1 node is offline or in service state


Bug fixes

 

Issue ID

Module

Description

CriticalBVQ-12519DBRepair entries with BVQ_ID = null
CriticalBVQ-12259InstallerMongoDB: Service does not start when password contains %
ImportantBVQ-12390AlertingPossible Exeption if filter condition of alert rule cannot be calculated
ImportantBVQ-12473GUI: Performance viewView > clone insists on a selection
ImportantBVQ-12443GUI: Performance viewNode Upper cache latency avg without decimal
ImportantBVQ-12323

GUI: Editor

VDisk group: Exception after assignment of multiple VDisk groups to Application
ImportantBVQ-12504

GUI: Performance indicators

Custom PI (longterm) leads to faulty latency calculation and response time compliance exception
ImportantBVQ-11640

Scanner

Connection error when using @ within SSH password
MinorBVQ-12508GUI: Path based chartingNullPointerException when creating PIP MultiView
 Version 5.3.2

Version 5.3.2

New features

Issue ID

Module

Description

 

Improvements

Issue ID

Module

Description

BVQ-12613

Installer

Show hint in installer dialog if default property values are used

BVQ-12244

Reporting

Excel: Consolidate URL, Title and Navigationbar


Bug fixes

 

Issue ID

Module

Description

CriticalBVQ-12580InstallerFix Pack check not working in some rare situations
CriticalBVQ-12570InstallerPasswords are reset to default if user has to be elevated
CriticalBVQ-12645SVC ScannerFlash System: VDisk can't be persisted because of missing preferred node
ImportantBVQ-12559SVC ScannerDrive Performance: Some metrics are interchanged
ImportantBVQ-12560GUIProperty dialog does not pop up
ImportantBVQ-12562GUI: TopologyException after right click on filtered host object
ImportantBVQ-12552

GUI: Favorite

Exception after invocation of favorite "Dissimilar copied volumes"
ImportantBVQ-12554

GUI: Performance view

Node CPU Core Compression stats about factor 100 too high
ImportantBVQ-12555

GUI: Performance view

Node CPU: Relation between Max CPU core and displayed chart curves are faulty
ImportantBVQ-12544GUI: TableNode ports: State "inactive_unconfigured" shows up as "unusual"
ImportantBVQ-12512ReportingSRS Capacity Report: SnippetParametersNotValidException
ImportantBVQ-12566ReportingSnippet loop creates wrong pie charts with all existing objects
ImportantBVQ-12571ReportingEditing of "system" templates via Reports overview should not be possible
MinorBVQ-12513GUIShortcut [CTRL+N] causes NPE in empty window
MinorBVQ-12591GUI: Performance viewChart visibility > Hide > Selected does not work
MinorBVQ-12533GUI: Performance viewMetric color change does not trigger a redraw
MinorBVQ-12590GUI: Performance viewAttribute "wh" for VDiskUpperCache has wrong normalization
MinorBVQ-12551GUI: Performance viewStart / End time: Cursor keys not consumed by input field
MinorBVQ-12589GUI: TablePortLogin: Attribute "state" does not display color icon in cell
MinorBVQ-12611GUI: Topology viewOptions Panel causes NPE if events are displayed
 Version 5.3.3

Version 5.3.3

New features

Issue ID

Module

Description

 

Improvements

Issue ID

Module

Description

BVQ-12692

GUI

Menu option to modify favorite information is renamed to "edit info"

BVQ-12702

GUI

Multi View: Refresh: Add shortcut "F5"

BVQ-12752

Server

Show supported browsers on login-pages

BVQ-12365

Filtering

Add possibility to filter by NULL

BVQ-12658

Reporting

Disable "System" Tree in Reporting Table Snipptes & Excel Interface.
Please copy System favorites to a folder in "All users", if you want to use them in your reports or data sources. System favorites could be changed without notice and thus are not stable for use in reports.


Bug fixes

 

Issue ID

Module

Description

CriticalBVQ-12725ScannerRemove dependency to the mongodb service
CriticalBVQ-12699ServerParsing large logfiles can cause out-of-memory errors
ImportantBVQ-12788Server Poor browser performance in environments without internet connectivity
ImportantBVQ-12690ScannerStatistics-collector can throw ConcurrentModificationException
ImportantBVQ-12799GUI: Performance viewNode CPU compression stats factor 100 too low (partially solved).
Aggregated node compression stats still 100x too low. Will be solved in 5.4.0
ImportantBVQ-12679GUI: Null objectFavorite to map Mdisks to drive arrays did not work.
ImportantBVQ-12630GUI: Path based chartingChart selection method differs from Treemap / Table
ImportantBVQ-12744GUI: EditorsFloat number input fields do not accept "." or "," correctly
ImportantBVQ-12754GUI: EditorsMDisk group & VDisk: Alert assignment change does not activate Apply / OK buttons
ImportantBVQ-12661GUI: FavoritesDB favorite store "version" field in MongoDB entity not changed after migration
MinorBVQ-12643GUIPerf-Cache: Bucket-fullness detection not always working correctly
MinorBVQ-12717GUIDrives show a capacity value of 0
MinorBVQ-7529GUIVMware: Names are slightly different
MinorBVQ-12638GUI: FavoritesFavorites: Menu: Only shows default icon. Custom Icons ignored.
MinorBVQ-12716GUI: Performance viewIllegalStateException: Next min date equals last min date 
MinorBVQ-12550GUI: Path based chartingInital Chart End time sometimes = Now instead of EoD
MinorBVQ-12701GUI: TreemapFilters: Changing Aspect with filters disables the "enable" checkbox in the menu
MinorBVQ-12659GUI: Filtering Does not support negative integers
MinorBVQ-12739GUI: FilteringParsing unit based values in CLI without unit does not apply default units
MinorBVQ-12737ScannerResearch repeating "Error connecting to host!" during topology scan
MinorBVQ-12787ScannerScanned data consitency check needs exceptions
MinorBVQ-12772Reporting"Capacity Report - Capacity per Cluster" missing stack graph in section "Overview of clusters"
MinorBVQ-12664InstallerReduce the number of scanner instances doesn't delete the corresponding folders and services
MinorBVQ-12706GUI: Favorites
Filter: Unit based values in filters not parsed correctly from technical CLI string
 Version 5.3.4

Version 5.3.4

New features

Issue ID

Module

Description

 

Improvements

Issue ID

Module

Description

BVQ-11986

Scanner

Installer for consolidated scanner (local & remote)


Bug fixes

 

Issue ID

Module

Description

CriticalBVQ-12826GUI: ObjectsPath "/BVQ/VM Datastore/VM Virtual disk" doesn't show any VM Virtual disks
ImportantBVQ-12825GUI: EditorsVDisk, MDisk group: Alert rules: Buttons below chooser missing
ImportantBVQ-12817ReportingClassCastExceptions from MDiskGroupCapacityDataTableRenderer
ImportantBVQ-12841VMware ScanTopology StringIndexOutOfBoundsException
MinorBVQ-12821BVQ ServerUsername validation: Allow "_" and "-" in username
MinorBVQ-12824GUIPI Calculation fails during time change in October
MinorBVQ-12828GrafanaReduce parallel consumer count

Page viewed 1366 times by 8 users since Aug 21, 2017

 


How-To install

Preparation of the operating system Windows

The following tests and adjustments should be made:

Action                                                              Short description
AdministratorMake sure that the installation of all components is performed by a user who is a member of the local user group 'administrators'.  
RestartsMake sure that the system can be restarted (several times) without any problems during the installation phase.     
Network connections
Disk storageSet up the necessary drives, paths and partitions to the recommended sizes as described in adjust disk storage configuration.
Minimize UACMinimize the Windows User Access Control configuration prior to the installation as recommended under: adjust user account control (UAC)
Customize virus scanner        If necessary, please customize the configuration of an installed virus scanner on the BVQ systems (see customize virus scanner)
Time and time zonePlease ensure that the clocks on all BVQ systems and other integrated systems are synchronized and set to the same time zone (please see check time and time zone) 
Windows userMake sure that the necessary conditions for Windows users are met. 

Additionally required software                    

Install the additionally required software on the BVQ systems
Contribution of BVQ license key files      Please ensure that your BVQ license key file is available in the download directory of your BVQ server. It will be needed for the BVQ installation.

Check and unlock network connections 

BVQ Services require the network connections to communicate with each other, with BVQ Clients and  the external disk- and VMware systems.    

(warning) Please adjust the settings of any existing firewalls accordingly.

(warning) Please check any necessary network connection by using ping.

Overview: possible network connection types

ConectionMeaning
RDPMicrosoft Remote Desktop Protocol for remote screen sessions
SSHSecure Shell to access the SVC CLI
VMware WSWeb service with HTTPS on VMware vCenter API
MongoDB clientClient to access the MongoDB Service
InternetConnection to the Internet for remote maintenance or code-download
Overview: possible network connection types


Overview: Network connections

The following connections should or must be provided for each system:

Links / SystemStandard TCP portBVQ DB ServerBVQ ServerBVQ Client
RDP to client workstation3389(tick)(tick) ←(tick)
SSH to SVC22 (tick)(question)
WS to vCenter443 

(tick)

 
MongoDB Client27017(tick)(tick)(tick)
InternetN/A(question)(question)(question)
Reporting Server80(tick)(tick)(tick)
Overview: Network connections

Legend: (tick) - nessesary connection, (question) - optional connection, → - outgoing connection, ← - incoming connection

 

Notes to Microsoft RDP

The GUI's operation on a BVQ server with the redirection of the screen display to a workstation by using Microsoft Remote Desktop Protocol (RDP) is supported, but is associated with a loss of image quality and speed. Therefore, we recommend to use the BVQ GUI screen directly without any diversion. In Windows 2008 Terminal Services environments certain settings have to be considered before installation starts (enable user installation mode).

Please see: http://www.techotopia.com/index.php/Installing_Applications_for_Windows_Server_2008_Terminal_Services 

(error) The cascading of two or more RDP sessions in a chain one after the other affects the display performance of the BVQ GUI enormously and is therefore not supported!

 

Adjust disk storage configuration

BVQ Services require a different amount of disk storage capacity at different times for program files, program data  and log files. For the approximately required capacity, please refer to the relevant document under BVQ supported environments.    

To ensure that in case of a problem overflowing directories does not endanger the execution of other services, we recommend to distribute main directories on multiple partitions or drives.       

 

Recommendations

  • At least for the MongoDB data directory an separate drive or a separate disk partition (typical D:) should be created on a fast SAN storage system.        
  • It is recommended to create the directory D:\bvq_downloads and to gather all necessary files for installation there.

 

The following main Windows directories are used to a significant degree:

Main directoryStandard pathTypical standard pathStandard driveUsage
Program files%PROGRAMFILES%\SVA\BVQC:\Program Files\SVA\BVQC:Storage of program files
Program data%PROGRAMDATA%\SVA\BVQC:\ProgramData\SVA\BVQC:Storage of service logs and queue data
Program files%PROGRAMFILES%\SVA\BVQ\bvq-mongodbC:\Program Files\SVA\BVQ\bvq-mongodbC:Storage of MongoDB program files
Program data%PROGRAMDATA%\SVA\BVQ\bvq-mongodbC:\ProgramData\SVA\BVQ\bvq-mongodbC:Storage of MongoDB database
Overview: BVQ main directories


A significant use can also be expected for the following main directories on each system:     

Directory / systemBVQ DB ServerBVQ ServerBVQ Client
Program files(tick)(tick)(tick)
Program data (tick)(tick)
MongoDB Database(tick)

 

 
Overview: main directories per system

Adjust User Account Control (UAC)

UAC - User Account Control Windows 2008 R2, 2012, Vista, 7, 8:

Microsoft introduced Windows Vista User Account Control (UAC) in Windows platforms to avoid that all actions are performed with administrator privileges.  

(warning) For the installation of BVQ components it is recommended to set the UAC temporarily to 'Never notify' (reboot required).     
When finished, it can be reseted to the previously set level. 

 

 How-To - Changes in the dialog 'UAC Manager'
  • Start UAC dialogue:
    • Either: start → execute/search field → enter: uac
    • Or: start → system control → path field → enter: system control\user accounts\user accounts → click 'Change settings of User Account Control'
  • Set control to lowest level 'Never notify'
  • After installation is finished reset control to original or desired value.


Customize virus scanner

(warning)  During the installation of BVQ disable any virus scanner or other programs which vary from the basis Windows installation and might interfere with the installation.

The virus scanner on the BVQ server should be set so that the following directories are NOT searched:

Database Directory
%ProgramData%\SVA\BVQ\bvq-mongodb
%ProgramFiles%\SVA\BVQ\bvq-scanner
%ProgramFiles%\SVA\BVQ\bvq-scheduler

Note: Problems has been observed in context with the virus scanner 'Sophos', which could be relevant for others too.

Check time and time zone

The time and time zone of the BVQ systems have to be set properly.

(warning) Please check whether a NTP server is configured in Windows: it is strongly recommended to use a NTP server to synchronize all clocks of all systems (SVC nodes, Windows) .

(warning) Please check whether the time zone is set correctly: the time zone of all systems (SVC, Windows) have to be set to the same value.

Check Windows user

Locally managed user

The following users and groups are created during the BVQ installation on the BVQ server. This chapter does not contain any adjustments to be carried out here and just provides an overview.   

(info) Often the username 'BVQ' is shared for the BVQ Service and DB user. In this case, the name of the BVQ Server may not be 'BVQ' as both the server and the user name are managed in the same Windows namespace .

TypeNameMember ofDescription
User accountbvqLocal administratorsBVQ user account (Access and create the database, updates bvq database, BVQ Windows services)
User account (optional)bvqservice BVQ Windows services run under this user account

 

User managed by active directory

If a domain registration is used, the database and the BVQ User must be created in advance on the AD server.
The following table provides an overview of the required users and their user groups in active directory.

Type

Name

Member of

Description

User account

bvq

Domain user, local administrators

BVQ user (Access and create the database, updates bvq database, BVQ Windows services)

 



Additional required software

The following overview shows which software is required on the BVQ systems:

Software / SystemBVQ DB ServerBVQ ServerBVQ Client
Java Runtime Environment (tick)(tick)
PuTTY (question)(question)
PDF Reader (question)(question)
Remote Screenshare(question)(question)(question)
Overview: additionally required software per system

Legend: (tick) - required software, (question) - optional software

 

BVQ installation packages

Download files

Please download the following software from the Internet on the BVQ ServerBVQ installer

 

Java Runtime Environment (JRE)

An Oracle Java Runtime Environment version 1.8.x with most current patches has to be installed on the BVQ server, database server and the clients.

Java 32/64 bit version

The Java Runtime Enviroment 32/64 bit version has to match the bit version of the operation System (not the Browser)

As the Browser is usually running as 32-Bit version the auto download on the java.com will download the wrong 32-Bit version. Please select your appropriate version from the manual download page: https://www.java.com/de/download/manual.jsp

 

The installed version of Java and the Java file association can be checked by using the following commands:

Check your java settings
:: Show current Java Version
C:\>java -version
java version "1.8.0_xx"
Java(TM) SE Runtime Environment (build 1.8.0_xx)
Java HotSpot(TM) 64-Bit Server VM (build xx, mixed mode)

C:\>C:\WINDOWS\SYSTEM32\java.exe -version
java version "1.8.0_xx"
Java(TM) SE Runtime Environment (build 1.8.0_xx)
Java HotSpot(TM) 64-Bit Server VM (build xx, mixed mode)


PuTTY (optional)

PuTTY is an optionally required free Secure Shell (SSH) terminal console. It is used to perform commands in the SVC CLI  .

Usually PuTTY is installed  on the BVQ Server and, if necessary, also on the client workstations. 

In a BVQ environment the following added values are offered with the installation and configuration of PuTTY:        

  1. PuTTY allows independent assessment of the SVC connections on the BVQ server and, if necessary, also the test or adaptation of SVC parameters.
  2. The pogram PuTTYgen  allows the user to create a SSH private/public key pairs, which may be needed for the configuration of the BVQ Scanner.
  3. A user may use pre-configured PuTTY sessions from the BVQ GUI, to adjust the configuration of SVC resources (see also Cluster CLI scripts).

For a working call out of the  BVQ GUI the following configuration steps have to be executed: 

(warning) Please attach the PuTTY directory  to the system search path %PATH% an (typically: ;C:\PROGRA~2\PuTTY ).

Can be configured in computer → properties advanced system settings Advanced → environment variables → user variables→ path

(warning) Please create a PuTTY session for each SVC / Storwize cluster  with the same name as the cluster (from lssystem name,  please note upper / lower case).

The following parameters have to be defined in PuTTY to connect to an SVC Cluster:

    • Category: session
      • Host name (or IP address) = IP address or DNS entry for the relevant SVC cluster 
      • Port = 22
      • Connection type = SSH
      • Saved sessions = name ot the relevant SVC Cluster
    • Category: connection -> aata
      • Auto-login username = bvq
    • Category: connection -> SSH -> auth
    • Back to category: session
      • Click button 'save' in order to store settings permanently

During the first connection the error message that the SSH fingerprint has not been saved in the registry can occur. This has to be confirmed once with 'Yes'.


Remote Screenshare (optional)                          

If you grant the BVQ support team a controlled access to a screen session on your BVQ systems, support for you and the BVQ team is greatly simplified. Answers for questions or errors can be found much faster and unnecessary back and forth sending of e-mails is avoided.

We recommend the installation ofl the software 'TeamViewer' on one or more BVQ systems which have access to the Internet. As a result, you can enable the BVQ support to work together with you on the local screen. TeamViewer can be downloaded from the Internet with the following link: http://www.teamviewer.com/de/download.

Some companies prohibit communication with the TeamViewer server (in Germany) by a firewall. In this case please contact your network administrator.




IBM SVC / Storwize systems

The following checks and adjustments should be made to the SVC / Storwize systems:

ActionShort Description
Configuration of SVC userPlease create a user account (typically 'bvq') within the group 'Administrators'.
Check SSH access for free sessionsPlease check whether 2 SSH sessions are free on each involved system in order to ensure communication with the BVQ SVC scanners.
Check time and time zonePlease check whether an NTP server and the same time zone are set on each involved system as well as on the  BVQ systems.
Check performance statistics intervalPlease check the settings of the performance statistics  on each involved system (default: 5 minutes).

Configuration of SVC user

For the communication of the BVQ SVC Scanner with the SVC CLI a user account on each SVC is mandatory, which should be at least member of the group 'Administrator'.

(warning) Please create such a user. We recommend that to give that user the following name: bvq

The user authentication can be done via SSH key pair and in recent SVC/Storwize code versions also via password.
The configuration of a user with password authentication is easier. For SSH key authentication  an SSH key pair has to be generated initially.

  • Creation of an SVC user with password for BVQ with SVC CLI:

    svctask mkuser -name bvq -usergrp Administrator -password P@ssw0rd

  • Creation of the BVQ user with SVC Web GUI:
    1. Please Browse with a web browser to the following URL: https://<cluster ip address>/gui#users-users
    2. Log in with a user in the group SecurityAdmin (superuser)
    3. Click on 'Create User" and fill in the following dialogue as following:

    4. If you have chosen an authentication via SSH key pair, you can upload the public key in this dialogue.

 

*Unfortunately, the performance monitoring of an SVC / Storwize cluster without the permission level 'Administrator' is not possible so far as for copying the performance statistics files from the other nodes into the config node the CLI command svctask cpdumps is mandatory. This is the only administrator-level command, which uses the BVQ SVC scanner. For all other commands (svcinfo lsxxx) the permission level 'monitor' would be sufficient. 

Check SSH access for free sessions

The number of simultaneously opened SSH sessions is limited in the SVC/Storwize to 10 sessions for SVC Code < 7.5. If the sessions are used by other applications, it should be ensured that for a short time up to 2 SSH sessions are simultaneously required for the communication with the BVQ SVC Scanner.
 

Check time and time zone

The time and the time zone of the SVC/Storwize systems have to be set correctly.

(warning) Please check if an NTP server is configured: we strongly recommend to use an NTP server to synchronize the time of all systems (SVC Nodes, Windows). 

CLI command for setting an NTP server:
svctask chcluster -ntpip <IP address of NTP Server> ### Example: svctask chcluster -ntpip 9.20.165.16

(warning) Please check whether the time zone is set correctlythe time zoneof all systems (SVC, Windows) should be set to the same value. 

CLI command for setting the time zone (here Europe/Berlin):
svctask settimezone -timezone 360 ### Timezone 360: Europe/Berlin !!!

(warning) At the end please check  whether  the expected time is actually displayed.

CLI command for showing the cluster time:
svqueryclock ### Check the cluster's current date and time

(info) If previously no NTP server has been configured , it is not advisable to delete the old performance statistics of all nodes at once because it is not certain that it they were created at the same time on each node.

CLI command for deleting asynchronous statistic-files if necessary:
svctask startstats -interval 5 && svcinfo lsnode -nohdr | while read id rest ; do svctask cleardumps -prefix /dumps/iostats $id ; done

 

Check performance statistics interval

The SVC performance statistics are generated regularly (in intervals) by the SVC and picked up by the BVQ SVC Scanner. BVQ supports all intervals possible in the SVC (1min to 60min).

We recommend to set the time interval to 5 minutes. If a closer monitoring should be necessary, the interval can also be reduced to 1 minute.

(warning) Please check the interval time set in the SVC / Storwize. Example:

svcinfo lssystem | while read key value; do [[ "$key" =~ ^(statistics_status|statistics_frequency)$ ]] && echo "$key $value"; done
statistics_status on
statistics_frequency 5

 (warning) If necessary, set the interval time to 5 minutes:

svctask startstats -interval 5 ### Set SVC Perf Statistics Interval (possible values 1-60)

Configure unified Storwize V7000

The V7000u system consists of 2 levels:

  1. The upper level provides a file service gateway (file nodes)
  2. The lower level consists of a V7000 (storage nodes)

The administration of a V7000u is usually done by using the IP addresses of the file service gateways. CLI commands are tunneled through that layer to the underlying V7000. Unfortunately, the performance statistics of the V7000 cannot be downloaded from this upper level . Hence cluster IP addresses have to be assigned to the underlying V7000.

(warning) Check whether a cluster IP address is set there on the V7000u:

lssystemip
cluster_id       cluster_name location port_id IP_address   subnet_mask   gateway       IP_address_6 prefix_6 gateway_6
00000200A080006A swv1blk      local    1       9.20.136.5 255.255.255.0 9.20.136.1
00000200A080006A swv1blk      local    2

(warning) If necessary, set a cluster IP address on the V7000u:

chsystemip -clusterip 9.20.136.5 -gw 9.20.136.1 -mask 255.255.255.0 -port 1

Similar to a usual V7000 the BVQ SVC Scanner has be configured  to access this IP address.

Create SSH key pair (optional)

 How-To - Create a SSH key with PuTTY for SVC authentication

For mutual authentication between SVC and PuTTY, an SSH-key is needed. The creation of an SSH-key is described in the following section:


Download PuTTY (puttygen.exe) from the following website: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
Then execute puttygen.exe:

  1. Accept the parameters SSH-2 RSA and number of bits in a generated key: 1024.
  2. Select 'Generate'. Then move the cursor over the popup window to the button 'Key is fully created'.
  3. The 'Key passphrase' and 'Confirm passphrase' have only to be entered, if the private key has to be additionally protected by passphrase.
  4. Select 'Save public key'. Enter a file name with the extension .pub (for example: SVCClusterName_Username.pub) and then save the file in a separate directory: eg * \ SSH_Key_SVC.
  5. Select 'Save private key'.



  6. Click 'Yes'. This confirms that you want to save the key without a passphrase.
    Then enter the file name with the extension of .ppk (eg: SVCClusterName_Username.ppk). Save the file in the same folder as the public key.
  7. Close the PuTTY key generator.


Upload public key in SVC

The key can be assigned to the SVC GUI to an existing user. Alternatively, a new SVC user for BVQ can be created.

1. Call the SVC GUI and authenticate as Security Admin or Superuser.
2. Select 'User Management' -> User.
3. Add the SSH public key to a new or existing users.
(warning) The SSH key user must be in the user group 'Security admin' or 'Admin'.

 




VMware vCenter systems

VMware vCenter user

For the operation of BVQ VMware Scanner, a user is required for the operation of the BVQ VMware Scanner, who should at least have read-only access to the VMware vCenter system.

(warning) Please create this user before installing the VMware BVQ Scanner. We recommend to name the user as follows: 'bvq'

 

 

 

Pre installation checklist


 

  • No labels