click to expand ...

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
Performance analysis and monitoring for IBM SVC and Storwize




Recent Version



VersionReleasedInstall Packages
5.5.508.01.2019All in OneGUI




New SAN Module

Brief description

The BVQ SAN Package is a complete new extension package for BVQ. It introduces support for Brocade SAN switches and directors. It enables you to interactively explore your SAN configuration and check it for issues, chart SAN Switch port performance and error metrics, create reports about port utilization and drill through all the layers between SVC, BVQ, and VMware objects in end to end views.


Similar to all other available BVQ add on packages, its licensing is based on the capacity of a licensed primary system platform (Spectrum virtualize (SVC), Storwize, ...). Please review the BVQ License Information Page or ask your sales contact for more information. 

Information gathering

To collect information a BVQ SAN Scanner needs to be configured to connect to a Brocade SMI/S Provider, which can be enabled as part of a Brocade Network Advisor (BNA). There is an issue with the Brocade SMI provider and the tracking of changes, so we strongly recommend to use the free (headless) Brocade SMI provider separately or at least to switch off "Track changes" in the BNA. See Supported environments and BVQ server requirements for more details and the supported versions of the Brocade SMI provider.

Supported SAN objects

This first version of the BVQ SAN Package supports basic elements of a SAN environment. The following overview depicts the elementary relationships of these objects and their link to connected BVQ objects:

Where to find SAN objects?

Similar to all other objects, they show up in the BVQ Path browser inside the view property panel or can be opened as a Table from the Favorite browser. All SAN objects can be combined in an end to end relation to all other objects.

SAN objects in view Path browserSAN object Table views in BVQ Favorites

 BVQ SAN object details
SAN AgentThe SMI Provider gathering information for the monitored SAN Devices
SANThe SAN to which the monitored SAN Fabrics belong to. Only routed SANs will contain more than one SAN Fabric in a SAN.

SAN Fabric

Part of a SAN, that contains one or more interlinked (logical) SAN Switches.
SAN SwitchRepresents a logical SAN Switch configured inside a physical SAN Switch or Director as part of a SAN Fabric.
SAN ChassisRepresents the physical SAN Switch or Director. A BVQ Room connected to a BVQ Site can be configured for it.
SAN Switch portFiber channel Port of a SAN Switch. This can be physically cabled to a SAN Node port or to a SAN Switch port of another Switch.
SAN TrunkMultiple SAN Switch ISLs can be bundled to a SAN Trunk to improve the performance an availability of a Switch to Switch connection.
SAN ISLInterconnection between two SAN Switch ports to bind another SAN Switch into the same SAN Fabric. Multiple ISLs can be grouped to a SAN Trunk
SAN Node portFiber channel port inside a SAN attached device (host, storage system, ...) connected to a SAN Switch port. BVQ directly connects them to gathered Ports of BVQ monitored storage systems.
Primary identifier: World Wide Port Name (WWPN)
SAN Node

One or more ports physically places inside the same device show up in a SAN Node.
Primary identifier: World Wide Node Name (WWNN)

SAN PlatformA configured FDMI driver of a SAN Node device can deliver more helpful information about the system driving the SAN Node ports (e.g. Hostname, Device driver Version).

Object attributes

BVQ displays the full set of all reported attributes for each supported SAN object. Be aware that only a subset of configuration parameters is reported by the Brocade SMI provider. In addition, BVQ calculates counters for each grouping object, so that their number of grouped objects are known. For example a SAN Fabric knows how many SAN Switches it contains, how many SAN Switch ports they have and how many of them are connected or free for use. Please explore the BVQ SAN Table view favorites to get an impression of the most important attributes.

Performance and error metrics

The BVQ SAN Package gathers all SAN Switch port statistics delivered from the Brocade SMI provider. Similar to all other statistics, you can simply drill into a chart with the statistics related to an object with a simple click on the SAN entry in the context menu of this object:

That opens our well known BVQ Chart view, where you can select statistic metrics in the selection panel. The following screenshot shows the full set of available metrics in the expert tab:

 SAN Switch port statistic details

These are the available SAN Switch port statistics in more detail:


Data transfer

Data rateRxMiB/sReceived data rate
Data rateTxMiB/sSent data rate
Data rateRx+TxMiB/sOverall data rate
Data rateRx%%% received of total transferred data

Frame rateRxFrames/sReceived frame rate
Frame rateTxFrames/sSent frame rate
Frame rateRx+TxFrames/sOverall frame rate
Frame rateRx%%% received of total transferred frames

Frame sizeRxByteFramesize received
Frame sizeTxByteFramesize sent
Frame sizeRx&TxByteWeighted average overall framesize

Frame rate by classRx C2Frames/sReceived class 2 frame rate
Frame rate by classRx C3Frames/sReceived class 3 frame rate
Logical layer

Buffer credit wait

%%Buffer to buffer credit zero wait %

Frame discardsRxTOFrames/sFrame timeout rate in receive buffer

Frame discards

TxTOFrames/sFrame timeout rate in transmit buffer

Frame discards

OtherFrames/sAll other frame discards not due to a timeout (unreachable, zone misses, unrouteable ...)

Offline sequencesRxCount/sOffline sequences receive rate
Offline sequencesTxCount/sOffline sequence send rate
Offline sequencesRx+TxCount/sOverall offline sequence rate

Link resetsRxCount/sLink reset receive rate
Link resetsTxCount/sLink reset send rate
Link resetsRx+TxCount/sOverall link reset rate

Invalid ordered setsRxCount/sInvalid ordered set rate
Physical layer
Encoding errorsInCount/sRate of encoding errors inside frame
Encoding errorsOutCount/sRate of encoding errors outside frame
Encoding errorsIn+OutCount/sOverall Encoding error rate

CRC errorsGEOFCount/sRate of CRC errors with good End Of Frame (EOF) delimiter
CRC errorsOverallCount/sRate of all CRC errors

Link errorsLFCount/sLink failure rate
Link errorsLSYCount/sLoss of sync rate
Link errorsLSICount/sLoss of signal rate
Lower level
ErrorsProtocolCount/sProtocol error rate
ErrorsAddressCount/sAddress error rate
ErrorsDelimiterCount/sDelimiter error rate
ErrorsToo longCount/sRate of too long frames

Use cases

You can find a collection of use cases on the BVQ SAN Package (Brocade) page.

Other information

 Known restrictions
SAN RoutingToleration support only. Full Feature support can be added to a later release
SAN ZoningWill be added in the next major release
SAN Access gatewayWill be added in the next major release
SAN Director bladeLimited support. Currently the blade slot number is unknown. This will be added in one of the next releases.
SAN NPIVLimited support. Full feature support will be added in the next major release
Separate SMI ProviderRecommended. A problem in the SMI provider of current BNA versions prohibits its use in combination with BNA change tracking.

SAN System Favorites (v5.5.3)

In v5.5.3 several predefined SAN favorites have been added. They allow a quick and easy overview or analysis of all SANs scanned by BVQ.

The following favorites can now be found in the System folder:

  • Table views for every SAN Object Type
  • SAN topology multiview favorites
  • SAN performance multiview favorites
  • Qualification of SAN objects
  • SAN analytic favorites

To get more information, either click on View Info for the selected SAN favorite in the System tree...

... or open a new favorite and hover the mouse over the window-symbol in the upper left corner of a window or view

A window will pop-up explaining

  • what the use case of the favorite/view is
  • how to interprete the displayed results
  • which information to expect/not to expect in the view and what the next recommended actions are

New Alerting Engine

With version 5.5 BVQ got a whole new alerting engine which replaces the old module functionality completely.

New key features:

  • Web UI to visualize alerting results
  • Flexible object selection to avoid manual mappings
  • Alert conditions based on topology attributes and all available performance indicators
  • Alert rule creation possible from the Web UI and the Classic GUI
  • New notification concept with new additional options

Alerting Web UI

The new Alerting Web UI is available via the BVQ-Server and splitted into two main areas Overview and Manage alert rules

  • Overview: Get an overview of the current and historical alert levels for all alert rules, one specific alert rule or even one specific object
  • Manage alert rules: Create, edit, delete or organize your alert rules


Manage alert rules

Alert rules can be created and edited form the Web UI and Classic GUI and require some configuration in different sections.

NameA user defined name for the alert rule. It should express the usecase for this rule.
Object Type

The object type is the base object, all alert conditions are applied on.

(info) From the viewpoint of the Classic GUI it can be seen as the last object in the path.

Default alert levelIf no alert condition matches in this rule, the default alert level is applied as current state (typical value: OK).
Fallback alert levelIf conditions can't be calculated the fallback level is applied as current state. This might happen, if there are missing performance values (typical value: Unknown).
EnabledOnly enabled alert rules will be calculated.

To define a subset of objects, the alert rule should be applied to it is possible to add multiple selection definitions. Each definition will be applied to a specific object type.
Selection definitions are evaluated top → down and can be rearranged using drag & drop.

(info) The selection actually is a topology filter in the Treemap and utilizes the powerful functionality of the enhanced filtering options.

Alert condition

It's possible to add multiple alert conditions with different alert levels and filters to one alert rule.
Alert condition filters are based on the enhanced filtering. As there is no visual assistant in the Web UI now, we recommend to create your filter within the Classic GUI. It is still possible to tweak or change the rules later in the Web UI.

(warning) Alert conditions are always evaluated top → down end exit with the first match.

Report config

One alert rule can contain multiple report configs. Per default there is a Default alerting file you can choose as report type (Notification). You can create your own Notifications and choose them as report type. All level changes are published to this Notification config and handled accordingly.

Using the From and To level, it is possible to define dedicated alerts. A notification will only be send if the level changes.

Execution config

Define the execution schedule for this alert rule using Cron syntax.

Comment Allows to add documentation about this alert rule



Notification concept

With this version we introduce a new concept to notify the user. Use the BVQ Web UI to configure all its options, like Notification configurations, Email servers, log filenames and others. You give each Notification configuration a specific name, by which it can be reused in any Alert rule.

(info) Although the notifications are only used within the alerting right now there are many plans for the near future to use this concept for different usecases.

(Email) Servers

The Email server can be used in multiple notification configurations. For that you need to give it an unique name.

Notification configurations

A Notification configuration defines how the notification should be delivered. The settings vary in detail based on the selected type.

At this time we support the following notification types:

 TypeSettings Notes
EmailEmail server, sender, recipientYou can add multiple receiver addresses using a ; as seperator
FileFilenameThe filename should already include the output extension (xxx.log)
SlackSlack webhook URL



SVC 8.2 & IBM FlashSystem 9100 support

On July 10th, 2018, IBM has announced the next generation FlashSystem product built with Spectrum Virtualize capabilities. The FS9100 is running SW version 8.2.0. BVQ is ready to scan and support both, the new hardware and the new software. This support was added in BVQ v5.5.2

SVC 7.6 & 7.8.1 feature support

SVC 7.6 - Distributed RAID (DRAID) support

A new type of RAID has been introduced in SVC v7.6 - Distributed RAID (DRAID).

While traditional RAID arrays have one or more dedicated spare drives which are idle unless an active member in the array fails, DRAID arrays have so called rebuild areas which means there is no dedicated spare drive and all drives in the array can do I/O.

DRAIDs have two major advantages over traditional RAID arrays: greater throughput and a massively reduced rebuild time in case of a drive failure.


There are a bunch of new attributes related to DRAID which can now be displayed in the Detail Pane for Object Type "Drive Array".

SVC 7.6 - Hyperswap & Remote Copy integration

When creating a volume on an SVC cluster configured in Hyperswap topology, four VDisks are created:

  • one "master" VDisk
  • one "auxiliary" VDisk which is in an active-active remote copy relationship with the "master" VDisk
  • two change volumes which are flash copy targets for "master" and "auxiliary" VDisk

All new SVC attributes related to the new feature are now included in BVQ.

To make it easier to find out which VDisks belong to a volume, BVQ displays the master's volume name (instead of its own VDisk name) followed by a suffix indicating the use of the VDisk. The names of related FC mappings are displayed in a similar way:

VDisk display nameFC map display name
MMaster VDiskM>MCMaster to Master change
AAuxiliary VDiskA>ACAuxiliary to Auxiliary change
MCChange volume for master VDiskMC>MMaster change to Master
ACChange volume for auxiliary VDiskAC>AAuxiliary change to Auxiliary

Some examples for RC relationships, FC mappings and related VDisks:

The same name-suffix-logic also applies to VDisks and FC mappings of GMCV relationships (Global Mirror with Change Volumes):


SVC 7.8.1 - Port Congestion Performance Statistics

Some additional SVC FC node port congestion statistics became available in SVC v7.8.1 which are helpful to explore problems between SVC and SAN. Prior to SVC v7.8.1 (which means 8GB FC HBAs), metric Buffer credit zero wait % (BBCZ) has always been helpful but this metric is no longer reported by 16GB (and newer) FC HBAs. To cover this gap, IBM developed this new congestion statistic set which is available for FC port types. Please refer to the IBM documentation for more details about them. Especially Transfer congestion > Normal > Blocked int % is the most comparable to Buffer credit zero wait % and has the same meaning: % of measured interval blocked due to congestion.

The new congestion statistics can be found in the metric chooser's Basic- and Expert-Tab of object type "SVC Node Port":

Basic Port congestion statisticsExpert Port congestion statistics

GUI Improvements

New menu to add table columns

Adding columns to a table is now much easier than in earlier releases because a new menu allows you to select multiple attributes at once. All attributes available for the selected object type including their description and CLI notation are listed in this new menu. Just right-click on the table header column and select "Table columns". The new menu opens and you can simply add one ore more new attributes by single-clicking on the check-box or double-clicking anywhere on the selected row.

Open the Table columns configuration panel from the table menuTable columns configuration panel in the view's properties

Enhanced Chart Context Menu

The chart context menu which open on a right click on the chart background has been made more user friendly. More actions can now be performed via a single menu:

  • use Timing to select a different time interval
  • choose Metrics to change, add or remove metrics
  • go to Objects to select the objects that should be charted
  • adjust Drawing options if required
  • select General to change the path to display different object types in a different hierarchy


Path Base Charting (PBC) in Object Context Menu

Path Based Charting was introduced in v5.3 (see v5.3 Introduction of PBC), continued in v5.4 (see v5.4 Enhanced PBC) and completely replaced the old chart view consistently in this release. Now a PBC view also opens, when called from the Object Context Menu. A so invoked PBC view opens with the chart in the top section and a table section showing all contained objects below it. A path is preselected for that view, that only contains /BVQ/<chosen object type>.  As usual, only the "Aggregated" object visible, but in a PBC view, the leading path element "BVQ" has taken over this role. The chosen object type path element is also filtered to only contain the objects that had been selected before the context menu was opened. To change the visibility of your objects, use the new Chart > Objects dialog in the view's properties or the Chart visibility menu options in the object context menu.

Call a PBC from Object Context MenuChange object visibility in View PropertiesChange visibility in Object Context Menu

Object specific actions in Table view

In previous releases, a all cells of a row in a Table view only behave as the primary object. For example, a double-click anywhere in the row opened the Detail pane for the given object of that row. In this release, all cells showing references to other objects allow specific action on these. For example, a double-click on such a cell will open the Detail pane for this object. Its Object Context Menu also offers specific actions (change chart visibility, call PBC, select it in another view, ...). A cell that supports that feature shows the object's name underlined.

Improved BVQ Server Web UI

The BVQ-Server Web UI has been migrated to a new CSS Framework (VueJS). In this process we improved many details and reorganized some pages.

Scanner overview


  • The old scanner overview showed a state based on the last task of a scanner or persist, which could lead to confusing results if tasks are executed in different schedules. For each task we now made a visual representation.
  • Scan and persist duration with their histograms have been moved to a separate screen. Click the status button to get to the new overview.
  • The log button disappeared. To view the logs you can just click the green/red button for each state of a scanner.

Reduced Sidebar Navigation Entries

  • Some top level navigation links in the sidebar are now grouped an a more appropriate Administration or Support group
  • Host, Database, Cache and Heap Information are now grouped in a new "System Information" page


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 64bit

Known Issues

(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 necessary to use certain 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. Preparations
    • Check for the correct function of the whole environmentin particular the function of the scanner.
    • Manual stop of BVQ Scanner-, Alerting- and  Scheduler-services and also all GUIs and reporting-clients
    • Backup the BVQ installation directory and BVQ DB (e.g. DB backup with mongodump or VMware snapshots) 
    • Restart the BVQ Scanner
  2. Update BVQ Install Package Repository: bvq-package-repository-installer-x64-V5.5(.x).exe
    1. MongoDB update
    2. BVQ GUI update
    3. BVQ Alerting update
    4. BVQ Server update
  3. Test the function of the BVQ environment.
  4. If necessary inform colleagues about the need to update locally installed BVQ GUI clients.  



 Version 5.5.6

Version 5.5.6

New features

Issue ID




Issue ID



BVQ-13760GUIAllow analytic favorites and views with more than one path element

Bug fixes


Issue ID



CriticalBVQ-13693GUI: Perf View: Node portSome calculation & aggregation errors in congestion metrics
MinorBVQ-13758ReportingRendering a favorite with chart & table can lead to NullPointerException due to missing columns

 Version 5.5.5

Version 5.5.5

New features

Issue ID




Issue ID



Bug fixes


Issue ID



CriticalBVQ-13689SVC Performance PersistFallback commands not executed when error occurs
CriticalBVQ-13667BVQ Server: ReportingTopology favorites are not shown correctly in snippet selector
MajorBVQ-13669BVQ Server: ReportingUnable to use pie chart in snippet loop
MinorBVQ-13662GUI: Table View: FilterException when trying to add a filter to data rate
MinorBVQ-13675CommonT2 calculation for nodeUpperCachePartition wrong configured

 Version 5.5.4

Version 5.5.4

New features

Issue ID




Issue ID



Bug fixes


Issue ID



CriticalBVQ-13552GUI: Perf view: Latency filterFiltered dots no longer appear

nssm.exe still opened by other Windows Services after it is stopped

CriticalBVQ-13573ScannerSVC Persister creates Offline SVC Node Objects without link to IO group
MajorBVQ-13536AlertingDuplicate Key Exception
MajorBVQ-13577GUI: Favorites: Site & RoomOverview has wrong filters for SAN Chassis
MajorBVQ-13279GUI: Multi view

Table columns open properties panel of other view

MajorBVQ-13500GUI: PBC: Properties: ObjectsTurn on of Table Section not relyable
MajorBVQ-13511GUI: PBCSpikes in BVQ-aggregate if interval is set to none
MajorBVQ-13478GUI: PBCWindow refresh raises change flag on affected PBC views
MajorBVQ-13570GUI: Perf view: Node port

Congestion Measured % of tot TX much too high

MajorBVQ-13484GUI: TreemapLegend contains PI Timing although no timing colorings or aspects are selected
MajorBVQ-13469REST InterfaceError message "no root element found"
MajorBVQ-13533SAN: LicensingScanner status green although SAN Module not licensed
MinorBVQ-13612GUI: Chart view: Metrics: SAN Switch portTooltip of GEOF has some typos
MinorBVQ-13507GUI: Editor Drive typeMulti Edit leads to duplicate named objects
MinorBVQ-13578GUI: FavoritesOpen (View) in new tab dos not respect current selection
MinorBVQ-13586GUI: FilterDialogNon sematic compatible special attributes available in "compareToAttribute"
MinorBVQ-13579GUI: Filtering: Add conditionOperator resets to "contains" unexpected
MinorBVQ-13550Installer: BVQ ServerUninstall always removes log and data aliases
MinorBVQ-13525WebUI: SchedulingCron-Syntax with weekday not accepted

 Version 5.5.3

Version 5.5.3

New features

Issue ID




Issue ID



BVQ-13476GUIAdd SAN System Favorites
BVQ-13423GUIImprove attribute descriptions for svc_name and volume_name


GUI: SANBVQ Qualified Attribute and Coloring missing
BVQ-13454GUI: PBCKeep non Isolate filters during PBC initalization & window refresh


GUI: Detail Pane

Improve handling of column width

BVQ-13451GUI: Chart ViewSet inital Tab of property panel to "chart > metrics"
BVQ-13495GUI: Perf view: Properties: Metrics: SANAdjust some metric tooltip texts
BVQ-13461REST InterfaceRemove Enum Numbers

Bug fixes


Issue ID




Fails to persist FS9100 node performance data


Path Trunk / ISL shows different Content than ISL / Trunk

CriticalBVQ-13422Attributes: SAN Port

"Is Connected" does not respect ISLs



GUI: Favorites

Exception after open of favorite moved into new directory

CriticalBVQ-13474GUI: Multi ViewException after Window Refresh

Trying to open a MV in a floating window leads to exceptions

MajorBVQ-13447GUIFilter comparison with "subelementcount" fails
MajorBVQ-13456GUILC Partition Performance chart displays incorrect data
MajorBVQ-13496GUIRight-click on SAN object in flat mode table leads to NPE
MajorBVQ-13411GUI: Table View

Filter becomes invalid when adding/removing table columns

MajorBVQ-13444GUI: Drive type table

IndexOutOfBoundsException: valid viewIndex: 0 <= index < 12 but was: -1

MajorBVQ-13446GUI: Editor: Disk typeEntered Name is not applied
MajorBVQ-13458GUI: TreetableClose of Table section leaves Property panel Table tabs open
MajorBVQ-13492GUI: Favorites: Edit info

Show in context menu no longer shows up

MajorBVQ-13493GUI: Perf view: Properties: MetricsFavo menu switching no longer works
MajorBVQ-13396Repository Installer

Not enough disk space: Log directory

MinorBVQ-13438GUICannot set a NULL value for an Attribute
MinorBVQ-13443GUIReload Topo Data doesn't display SAN Agents
MinorBVQ-13069GUI: Properties: ChartProperties

Big Metric Panels are not displayed completely

MinorBVQ-13326GUI: LUN: Detail pane"LUN #" shows HEX instead of DEC value


GUI: FilterDataAttributeRenderer parsing values with wrong unit

 Version 5.5.2

Version 5.5.2

New features

Issue ID



BVQ-13375 & BVQ-13386Common: SVCAdd support for new FlashSystem FS9100 and SW level 8.2
BVQ-13136GUI: PBC PropertiesAdd tab "Chart objects" with visibility controls


Issue ID



BVQ-13150GUI: Detail paneAll tab should have preference before Alert tab
BVQ-13412GUI: PBC Perf view"Chart visibility": Add "This layer" entry
BVQ-13387GUI: Property panel: ChartingRestructure Tabs

Bug fixes


Issue ID



BlockerBVQ-13400GUI: Properties: Chart

Metrics Dialog empty if PBC is calld by OCM


Unable to migrate DB from 5.5.1 to a later version

CriticalBVQ-13280GUI: SANPath /BVQ/SAN Agent/SVC Node displays incorrect information
CriticalBVQ-13395SAN: ScannerPersister runs on error parsing Date/Time of some attributes

Config files not deleted if moved to another instance

MajorBVQ-13238GUICPU Core Chart displays values > 100%
MajorBVQ-13410GUI: Chart visibility"Manage" doesn't always open proper tab in Properties Panel
MajorBVQ-13394GUI: Perf-View: SAN Switch PortBCW% shows values > 100%
MajorBVQ-13310GUI: Table viewColumns can't be switched back to unsorted
MajorBVQ-13361SANTopology and performance file cleanup incorrect
MajorBVQ-12858SVC PersisterPersisting of topology data fails with "Update operation not valid! enclosure_id must not be null!"

All User-Favorite not working after update

MinorBVQ-13378GUI Exception: "Found 5 DockableNode but 6 DockingState"
MinorBVQ-13315GUIBroken alignment in detail for new PI metrics
MinorBVQ-12876MongoDB InstallerError creating user on mongodb
MinorBVQ-13384ServerMongoDB Schema migration fails
MinorBVQ-12901Repo InstallerGUI not starting after update
 Version 5.5.1

Version 5.5.1

New features

Issue ID



BVQ-13073Common: Data Reduction PoolsAdd new Unmap/Data Reduction perfstats


Issue ID



BVQ-12927Web UINew Web UI with improved usability
BVQ-13058GUIDisplay port type for controller and host
BVQ-13216GUI Enable "Chart visibilty", "Isolate" and "Select subelements" in link-object context menu
BVQ-13065GUIFavorite menu usability impovement

Main menu: Favorites: Alert rules: Add functions

BVQ-13259CommonRemove metrics for SVC code level 7.2
BVQ-13198CommonRename SAN Performance Metrics
BVQ-13057CommonSVC 8.1.2: Support efficiency type of vdisks in DR pools
BVQ-13212CommonSVC: Rename Change VDisks according to Master/Auxiliary VDisks

Bug fixes


Issue ID



CriticalBVQ-13282GUI: TableFlipping Column widths with enabled auto compact
CriticalBVQ-13273GUI: PBCCharts don't show different objects with same name
CriticalBVQ-13298GUI: PBCSelection in chart not always hits the right object in table

Division by zero-Exception when opening "General Performance Overview"

MajorBVQ-13263GUIHandle view saving dosen't work correct
MajorBVQ-13306GUI: Table

Change flag not triggerd by most changes in tables

MajorBVQ-13254GUI: FavoriteAnalytic Multi-Views don't show up in object context menu
MajorBVQ-13257AlertingMDisk group selection filter cannot be added to an alert rule
MajorBVQ-13244Alerting: EditorBe able to commit "Add selection" dialog with only the Aggregate flag set
MajorBVQ-13289Scanner: Remote

SAN scan fails because of different folder structure

MajorBVQ-13292PersisterSAN: Persist error parsing date "CEST" with german syslang

Historical Reports unable to render if cluster id changed

MajorBVQ-13287BVQ-ServerShutdown during SRS Capacity Report rendering
MinorBVQ-13270GUIDelete discovered systems doesn't support SAN
MinorBVQ-13153GUINPE when closing the last MV-frame in a floating window
MinorBVQ-13182GUISelect managed systems dialogue doesn't show vCenter systems properly
MinorBVQ-13227GUI: TableAuto compact flips back after closing property sheet
MinorBVQ-13276GUI: TableColumn attribute chooser: Column "Object" can be removed
MinorBVQ-13068GUI: ChartSpikes in LineCharts if 2 data points are very close
MinorBVQ-13340GUI: ChartContest menu: Save as PNG missing
MinorBVQ-13250GUI: Detail pane32 GB Port speed not shown correctly
MinorBVQ-13309Grafana"Node detail" dashboard has a fixed timing


 Version 5.5

Version 5.5

New features

Issue ID



BVQ-3722CommonIntegration of SAN system components
BVQ-10139GUIPath integrated Perf-View
BVQ-12445GUI/ServerAlerting 2.0
BVQ-12598ServerBVQ Notification Config
BVQ-10172Common: SVC 7.6Distributed RAID (DRAID) support
BVQ-10173Common: SVC 7.6Hyperswap & RC enhancement integration 
BVQ-12077Common: SVC 7.8.1Add new port congestion perfstats
BVQ-12975GUIGUI: Add possibility to open a DP from a table cell referencing another DataObject


Issue ID



BVQ-13036Perf: DAOCreate combined DAOs via annotation processor
BVQ-13093Server: Reports

Reports should not have default names

BVQ-11592AlertingEnable sending test Email
BVQ-12629Alerting 2.0Add Fields to AlertRule and AlertReportConfig
BVQ-12989GUI: Chart Context MenuApply more options to "save as" 
BVQ-11100GUI: Chart viewRestructure chart context menu
BVQ-12182GUI: Chart viewTime legend: Add duration 
BVQ-12960GUI: FavoritesExtend favorite menu
BVQ-12104GUI: FavoritesEnhance save dialog with some file & folder operations
BVQ-12832GUI: FavoritesImprove Favo Manager Window handling
BVQ-13032GUI: PerfCreate/Update basic metrics panel
BVQ-4073GUIReload DB button should open cluster selection dialog
BVQ-13074GUIRemove "At least 1 scanner has an error!"-toaster
BVQ-13080GUI:Table ViewAdd table column selection to Property panel
BVQ-12556GUIView-Properties: Add Forwards / Backwards buttons to title bar
BVQ-12633GrafanaPreserve configuration and dashboards during update
BVQ-9624ScannerScan SVC Cluster partnership via "lspartnership"
BVQ-12703ServerLower priority of Report generation vs Scan
BVQ-12710GUIUpdate/Modify/Change/Improve Attribute Descriptions

Bug fixes


Issue ID



CriticalBVQ-13137GUI:Topology ViewMDisk groups missing after path change
MajorBVQ-13175GUI:Table View

Filter mode: Topology counter filter are Text instead of Int

MajorBVQ-13138GUI:Table ViewNULL objects shows no name in column "object"
MajorBVQ-12916GUIDataReductionPools: Topology Persist:NumberFormatException
MajorBVQ-10978GUI:DockingFaulty restore after maximizing within a floating frame
MajorBVQ-13157GUI:Topo Table

Attribute IO density leads to StackOverFlowException 

MinorBVQ-12420DataGridCRUD of objects blocked by PI load
MinorBVQ-11393GUIFloating Frames do not center title in freespace between menu and buttons
MinorBVQ-12168GUIFloating the last Single View of a window leads to non-dockable floating window
MinorBVQ-12961GUIJFreeChart 1.5.0 migration
MinorBVQ-11702GUI:Multi ViewFavorite ignores minimized Single Views
MinorBVQ-12272GUIOptimistic Locking not for all editable Object Types
MinorBVQ-12982GUI:FilterNo parser available for strings starting with numbers

Page viewed 1259 times by 9 users since Apr 20, 2018


How-To install


Preparation of the Windows operating system

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: Network connections and ports

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

Links / SystemStandard TCP portBVQ DB ServerBVQ ServerBVQ ClientDescription
RDP to BVQ Client3389(tick)(tick) ←(tick)Microsoft Remote Desktop Protocol for remote screen sessions
SSH to SVC System22 (tick)(question)Secure Shell to access the SVC CLI interface
WebService  to vCenter443 


 Web service with HTTPS on VMware vCenter API
SMI provider to BNA5989
SMI interface to Brocade Network Advisor
MongoDB27017(tick)(tick)(tick)Client to access the MongoDB service
BVQ Server Web UI80
(tick) ←(tick)Client acces to BVQ Server Web UI
BVQ Server Grafana3000
(tick)(tick)Cleint access to BVQ Grafana Dashbord Web UI
InternetN/A(question)(question)(question)Connection to the Internet for remote maintenance or code-download
Overview: Network connections

Legend: (tick) - necessary 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: 

(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.       


  • 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

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 users

Locally managed users

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

Users 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.



Member of


User account


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)
Microsoft Excel 2016
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 64 bit with most current patches has to be installed as the main system JRE on the BVQ server, database server and the clients.

JRE 32/64 bit versions overwrite each other

Internet browsers usually run as 32-Bit versions. If they are used to install a JRE, they auto-download a 32-Bit version and overwrite a 64-Bit system java. Please ensure to reinstall a 64-Bit JRE afterwards.


The installed version of Java and the existence of the java.exe in the system path can be checked by using the following command:

Check your java settings
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)

Microsoft Excel

Microsoft Excel 2016 or later has to be installed on the BVQ Server to be able to create advanced BVQ Reports with that. BVQ Excel based reports are connected to the BVQ Server's REST endpoint via MS PowerQuery, which is embedded in Excel since version 2016. You can automate the creation of such Reports by using MS Powershell and Windows Scheduler. Please ask your BVQ Support Partner for more information.

PuTTY (optional)

 Click here to expand...

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
      • Private key file for authentication = select a SSH private key file.
    • 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)

 Click here to expand...

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:

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


IBM Spectrum virtualize (SVC), Storwize & Flash 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 3 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 only done via password SSH key pair  authentication is no longer supported by BVQ)

  • 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 < v7.5 (32 sessions >v7.5) . If the sessions are used by other applications, it should be ensured that for a short time up to 3 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

(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

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) 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) Set the statistics interval time:

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

(warning) Clear old performance statistic files on all nodes. It is not certain that they were created at the same point in time or they may contain no longer existing nodes.

svcinfo lsnode -nohdr | while read id rest ; do svctask cleardumps -prefix /dumps/iostats $id ; done

Configure a 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:

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

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

chsystemip -clusterip -gw -mask -port 1

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

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'

VMware vCenter statistic settings

With BVQ version 5.6 it will be possible to scan performance data for VMware objects (virtual machines, ESX hosts, etc.) within BVQ. The following statistics settings are required:

  1. Log in to the vCenter web client (https://DNS_or_IP_of_vCenter_server) with an administrative user
  2. Navigate to the vCenter settings

    Select: vCenter → Configure tab → Settings - General  → Statistics
  3. To collect VMware performance data for BVQ the 5 minutes interval duration must be set to statistics level 3 - You can check the current settings in the table (screenshot shows correct configuration)
  4. To modify click "Edit" top right
  5. Within the next dialogue you can set the statistics level to 3 within the drop down menu

    Tip: Check the required database size required by configuring the physical hosts & virtual machines. Depending on the selected configuration, this will show you an estimate of the db size (filesystem space required on the vCenter server).
    (warning) Maybe you have to modify the vCenter filesystem size to collect/save the additional performance data.
  6. Click OK to save the settings
  7. Check the changes within the overview table (see 2.) →  5 minutes interval duration must be set to statistics level 3

vCenter CPU usage during BVQ performance scan

During the BVQ performance scan of a vCenter server the CPU usage of the vCenter server will increase. Please monitor the vCenter server utilization depending on the workload to avoid performance degradation.

VMware vCenter configuration settings

With BVQ version 5.6 it will be possible to scan performance data for VMware objects (virtual machines, ESX hosts, etc.) within BVQ. The following configuration settings are required:

  1. Log in to the vCenter web client (https://DNS_or_IP_of_vCenter_server) with an administrative user
  2. Navigate to the vCenter settings

    Select: vCenter (1) → Configure tab (2) → Settings - Advanced settings (3) → Edit (4)
  3. Use the Search field and search for config.vpxd.stats.maxQueryMetrics and check if value is set to -1 (5)
  4. If the setting is missing / not found use the lower area of the edit window to add this setting (6):
    • Name: config.vpxd.stats.maxQueryMetrics
    • Value: -1

Brocade SAN Scanner

Important Requirement: a separate system/server is needed to run the Brocade SMI Scanner

Brocade SAN Switch user

For the operation of BVQ Brocade SAN Scanner, a user is required on the SAN core switch.
The user
should at least have "Operator role" and AOR (Areas of Responsibility) =All Fabrics, All Hosts.


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

Gather information for BVQ Scanner configuration

BVQ scanners need the following information to be configured for each System.

In addition to the BVQ licensed IBM Spectrum virtualize systems (SVC), BVQ Scanners should also be configured for each BVQ supported backend system behind them. Such Systems are already covered by your BVQ license and can be added without additional cost, but be aware to have them included in your BVQ license key file.

For each IBM storage system:

For a VMware vCenter system:

Pre installation checklist


  • No labels