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

 


Download

 

Recent Version

 


Versions

VersionReleasedInstall Packages
5.4.424.05.2018All in oneGUI
5.4.315.05.2018  
5.4.216.03.2018  
5.4.108.02.2018  
5.4.011.12.2017  

 

 

 

 

 

 

 


Highlights

Capacity charting

A highly flexible capacity charting system is finally available inside the BVQ GUI.

In the past, capacity charting was only possible by using predefined reports with a fixed set of object types. It is now possible to chart all capacities the object is aware of. Charting options are provided as absolute and relative metrics for provider and consumer.

The usage is similar to performance charting with some minor differences:

  1. Capacity chart will open without any metric selection
  2. Default time range is set to 1 week
  3. Default interval is set to 6h and minimal time interval is 1h

Capacity charting performance depends on different conditions:

  1. Time range: The larger the slower
  2. Intervall: The bigger the quicker
  3. Selected Metric: If the object knows this capacity by itself, loading is much faster than calculation based on other objects

Major Web Dashboard Improvements

A lot of improvements and new features are introduced and now available for the web dashboard.

  1. It is now possible to create, save and customize your own dashboards.
  2. Predefined dashboards are still immutable but can be saved as a copy with your own adjustments.
  3. The bvq user ist now promoted to administrator rights
  4. The object and metric chooser got a lot of usability improvements

 

Furthermore we introduced the toplology metric type. This allows to chart all topology based values which are represended as number or percent in graphs or single stats widgets.
This also allows you to show capacity charts inside the web dashboard.

 

For further intormations how to use the grafana based web dashboard please visit:

  1. http://docs.grafana.org/

Introduction of Design IO Density for MDisk group & Storage Class objects

With previous versions of BVQ it was difficult to simulate what would happen if an MDisk group had more or less IO density.

The introduction of a "Design IO density" for MDisk groups and Storage class simplifies this simulation.

 

"Design IO density" (DIOd) co-exists with the already existing "Estimated IO density" (EIOd). While the latter is derived from IO density configured per BVQ Disk Array, the first one is configurable per MDisk group.

Analogue to "Default Design Response Time", a "Default Design IO density" (DDIOd) can be configured per Storage Class. If this Storage Class is defined for the MDisk group, DDIOd is automatically transfered to it as DIOd.

 

DIOd values can be added and modified using the MDisk group editor:

 

 

Or you can define DDIOd in the Storage Class editor:

 

 

Multiple DIOd related values and calculations can be displayed in the table views:

 

 

The new DIOd parameter is also reflected in the Object Coloring: In addition to the existing EIOd coloring, DIOd can also be displayed using the same coloring rules.

 

Report scheduling

BVQ Reporting is now enhanced with a powerful scheduling. Each report can be scheduled easily by using the schedule button in the template list.

The schedule will be defined using a cron syntax. To simplify the process a simple and advanced option is availible.

Simple schedule

  • Define your schedule execution using dropdown fields

Expert schedule

 

Range will define the time period the report will be generated for. It is allways the schedule time-range.

Example:

Schedule time: 11.12.2017
Range: 2 weeks

Report timeframe: 27.11.2017 - 11.12.2017

VDisk copy capacity difference

In most cirumstances different configurations of vdisk copies are unwanted. They might occur in historically grown configurations and are difficult to detect.

To make detection easier a capacity inconsistency factor has been added for real, used and free capacities of vdisk copies.

Primary to secondary capacity difference (P2S)

This new attribute can be used inside tables and for any advanced filtering.

 

Favorite

A new (updated) system favorite using this attribute will be introduced in version 5.4.1

 

Enhanced path based charting (PBC)

While path based charting feature (PBC) was introduced in BVQ 5.3 with some missing objects it is now available for all objects in BVQ. You are now able to create predifined charts with aggregated metrics of your own custom selections.

We added PBC support for the following metrics for all objects which are aware of these metrics:

  • MDISK GROUP CACHE PARTITION UPPER CACHE
  • MDISK GROUP CACHE PARTITION LOWER CACHE
  • SVC NODE CPU CORE


For further informations about PBC see: Release notes BVQ 5.3: Path based charting

PBC Chart report snippets

All PBC chart favorites are now available as snippets for report generation:

Enhanced BVQ Server user roles

To support more dedicated users we extended the user role concept and the predefined user roles. It is now possible to choose out of 10 predefined roles that can be assigned in all kinds of different combinations. This will allow to create read-only users, dedicated users for scanner managementes etc.

To view the detailed permissions of a user role, just click the (question) next to the role name.

The roles Alert rule administrator and Alert rule viewer are defined ahead for the upcoming alerting features in the future.

 

BVQ Server Maintenance Mode (v5.4.1)

BVQ Server now has a maintenance mode which is started if essential information that prevents BVQ from operating is missing.

An administrative user is required to login to the server at http://<bvq_server_address> and perform the relevant steps.

 

The following circumstances trigger BVQ server maintenance mode:

  1. First time installation
  2. Java version not supported
  3. Schema level not compatible with current DB version
  4. BVQ scheduler not (yet) configured
  5. BVQ license not installed, expired or invalid

 

 

Once logged in, the navigation panel on the left shows you which corrective actions need to be taken. Those items are marked with (error).

 

Although you will be automatically directed to the first item requiring action ((error)), you can review the other ones ((tick))as well.

 

 

 

Once all steps are completed, BVQ server will leave maintenance mode and restart the server in normal operation.

 


 

 

The regular server start might take some minutes so don't be scared if the server login page isn't available immediately.

 

 

 


 

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

 

Changelogs

 Version 5.4

Version 5.4

New features

Issue ID

Module

Description

BVQ-12492

Common

Broadened performance data

BVQ-12595

Common

SVC 8.1 Toleration Support

BVQ-10174

Common

SVC 7.6: Pool (CPU) based encryption integration

BVQ-12435

GUI: Chart view

Combine "Node CPU (Agg), Node UC and Node LC" to one PerformanceViewType

BVQ-10881

GUI: Attributes

Show capacity inconsistency factor between VDisk copies

BVQ-7908

GUI: Chart view

Show capacity charts
BVQ-12547ReportingEnable Path Based Charts in reporting
BVQ-12339ReportingEnable scheduling of report generation
BVQ-12481ServerImproved security-concept and roles


Improvements

Issue ID

Module

Description

BVQ-12618

Reporting

Clone templates

BVQ-12667

Reporting

Template in template list should be sorted

BVQ-12755

Server

Option switch for various modules

BVQ-12626

Capa Charting

Adjust interval handling

BVQ-12102

GUI: Favo manager

D&D with CTRL pressed should copy instead of move

BVQ-12274

GUI: Filtering

Enhance picker for attribute to attribute conditions

BVQ-12181

GUI: Perf View

Extend click sensitive area of checkboxes to include label
BVQ-9263GUI: TreemapShow virtual, used and free VM capacity in tooltip for VM LUNs
BVQ-12576Grafana: DashboardLayout adjustments
BVQ-12675Grafana: DatasourceAllow filter and groupBy expressions in MetricQuery
BVQ-12687Grafana: DatasourceAllow filter in TemplateQuery
BVQ-12781InstallerDisable perfomance data expiry in mongodb installer
BVQ-12709InstallerRemove SVC & VMWare scanner modules from Repository Installer
BVQ-12791InstallerRemove skip screen
BVQ-12695SVC snap converterAdd more details to readme
BVQ-12708SchedulerScheduler cleanup


Bug fixes

 

Issue ID

Module

Description

CriticalBVQ-12549GUI: Table ViewRC relationship: Cluster partnership not shown in all rows
MinorBVQ-12172GUI: EditorsColoring for multiple values inconsistent
MinorBVQ-12037GUI: EditorsMulti edit: Text "Multiple values" not correctly aligned
MinorBVQ-12098GUI: EditorsEmpty string not always consistent NULL or ""
MinorBVQ-12060GUI: Perf ViewOption panel still shows content when corresponding view is closed
MinorBVQ-11821GUI: Perf ViewEnabling "Live monitor" with free interval destroys timeline on bottom (Null)
MinorBVQ-12045GUIShutdown selection dialog not working for Exceptions
MinorBVQ-12234

GUI: Treetable

Null pointer exception on objects that are already deleted
MinorBVQ-12396

Reporting

Error handling broken when trying to generate invalid template
MinorBVQ-12610

Reporting

Reports in filesystem are not always deleted
MinorBVQ-12619

Reporting

Template validation doesn't work for snippet parameter
MinorBVQ-12655

Scanner

DiffPersister creates Diffs with interfval > min in certain circumstances
 Version 5.4.1

Version 5.4.1

New features

Issue ID

Module

Description

BVQ-12482Serverincreased responsibilities: Maintenance Mode
BVQ-12862CommonFlashSystem v1.5 Toleration support
BVQ-10876CommonIntegrate node FC port config information
BVQ-11059GUIIntegrate Design IO Density for MDisk groups & Storage class
BVQ-12764Reporting:GrafanaCapacity Charts


Improvements

Issue ID

Module

Description

BVQ-12873ServerAuto-Logout if server is restarted or auto-logout persiod due to user inactivity is reached
BVQ-12625GUI: Capa ChartingActivate EoD Button
BVQ-11565GUI: Favorites: Info TooltipAdd favorite folder path
BVQ-11742GUIMDisk Tier should also have a disk class. Default MDisk coloring should use this attribute instead of tier number coloring
BVQ-11544GUI: Perf View:Chart PropertiesTitle color does not respect L&F
BVQ-11799GUI:Properties (Topo & Perf View)Use tabs instead of Taskpanes
BVQ-11451GUI:TreetablePI Timing should be auto-choosen according to current PI set
BVQ-12801Installer:GUIUpdate Readme
BVQ-12674Installer:GrafanaExpose port configuration and preserve grafana.db and custom.ini
BVQ-12660Server:Scanner:Log ViewDisable scrollbar autohide & enable up/down cursors for scrolling


Bug fixes

 

Issue ID

Module

Description

CriticalBVQ-12798CLI PersisterCLI Persister fails to start
MajorBVQ-12289AlertingFlapping alert results to fallback level and back almost every hour
MajorBVQ-12780Server:PersisterUnable to persist svc eventfiles
MinorBVQ-12823GUI:Analytic favoritesGaps are not saved properly
MinorBVQ-12581GUI;DP:Accountables:SVC compression rate (estimated)VDisk copy bar is displayed incorrect
MinorBVQ-12299GUI:Editor"Reset" removes valid entries from tables in editor
MinorBVQ-12300GUI:EditorChanging name of an application is not reflected in parent vdiskgrp editor
MinorBVQ-12849GUI:EditorNumber fields cannot be reset to empty in VDisk group and MDisk group editors
MinorBVQ-12287GUI:Path Browser:Text ModeException after input
MinorBVQ-12587GUI:Tree Table: Filter ModeFilter not always reset on path change
MinorBVQ-12751GrafanaWidth of Scroll bars too large if write cache is full
MinorBVQ-12906InstallerRemove obsolete "skip screens"-checkbox from welcome screen
MinorBVQ-12197Installer:Mongo DBRollback incomplete
MinorBVQ-12815Installer:Mongo DBTypo and missing help information
MinorBVQ-12688PerformanceNodeCore aggregate with MAX
MinorBVQ-12903ServerUncheck dependency not working
MinorBVQ-12838GUI: FavoritesTypo in one of the Favorites
 Version 5.4.2

Version 5.4.2

New features

Issue ID

Module

Description


Improvements

Issue ID

Module

Description

BVQ-13005Server:Maintenance ModeShow supported browsers in login screen
BVQ-11897CommonEvery object should have a visible name attribute
BVQ-12836GUI:Capacity ChartingCharting should only draw until EndOfData
BVQ-12950GUI:Detail paneImprove tab usability
BVQ-13012GUI:Open WindowsFavorite tree embedded in an own window
BVQ-12852GUI:Topology ViewSearching takes a long time in large environments
BVQ-12998ServerMirror scanner type in zip structure when collecting scanner logs
BVQ-11387DocumentationDocument Keyboard Shortcuts
BVQ-11363SVC 7.7.1New HW Model support
BVQ-12840SVC 8.1Add cache sizes for SVC mode SV1/AC3 and Storwize Model 600


Bug fixes

 

Issue ID

Module

Description

MajorBVQ-12997GUI:Perf ViewReadout shows empty values (–) although data exists
MajorBVQ-12827CLIReenable standalone CLI
MajorBVQ-12943GUI:Topology:TableSpecial PI set does not display all PI attributes
MinorBVQ-12913Backup-/Snap-ConverterConverts of FlashSystem backups lead to not persistable topology files
MinorBVQ-12900GUIAutoPlay switching to off for charts based on data getting into the system with an interval > 5 min
MinorBVQ-13007InstallerDouble BVQ banner image on finish dialog in repository installer
MinorBVQ-12984Perf:ChartNullPointerException opening Node2Node chart
MinorBVQ-13009Perfdav, sav, pav are not persisted for NodeUpperCache
MinorBVQ-12935Scanner:Topology ScanNullPointerException
MinorBVQ-12980ServerPrevent loading of Favorites during server start in MimicryTableDataPieChartRenderer
MinorBVQ-12922Server:Scanner LogsSelecting a log files doesn't always work
MinorBVQ-12915GUI:Topo ViewNullPointerException
MinorBVQ-13004GUI:Open WindowsFavorite tree should behave like Properties window
 Version 5.4.3

Version 5.4.3

New features

Issue ID

Module

Description


Improvements

Issue ID

Module

Description


Bug fixes

 

Issue ID

Module

Description

CriticalBVQ-12992ScannerUnable to scan Cluster Performance because of "Unexpected Performance file count"
MajorBVQ-12997GUI:Perf ViewReadout shows empty values (--) although data exists
MajorBVQ-13038GUI"Unused Capacity" favorite is missing filter definitions
MajorBVQ-13105GUI: FavoritesQuotes aren't serialized properly
MajorBVQ-13047GUI:PBC

Autoscale doesn't work properly

MajorBVQ-12585Scanner

iSCSI Host Ports are not recognized

MinorBVQ-13029GUI

Exception when displaying foreign / linked object in table when link has different type for DOTs in path

MinorBVQ-13030GUI

Exception when displaying linked object column based on a transitive link

MinorBVQ-13031GUI

Linked object column not displaying transitive link and vice versa

MinorBVQ-13034GUI:PBC

No object context menu on BVQ aggregate line

MinorBVQ-13035GUI

Properties menu not open by double click

MinorBVQ-13076Server

Add option to disable infinispan statistics

MinorBVQ-13088GUI:Treemap

Children are only created for the first NULL object even if multiple of the same type exist

MinorBVQ-13076ServerAdd option to disable Infinispan statistics
 Version 5.4.4

Version 5.4.4

New features

Issue ID

Module

Description


Improvements

Issue ID

Module

Description


Bug fixes

 

Issue ID

Module

Description

MajorBVQ-13099Alerting

Cloud: reload ignores performance indicators

MinorBVQ-13158SVC Offsite Scanner

DecryptPropertyPlaceholderConfigurer not used

MinorBVQ-13043VMware Scanner

Scan is interrupted because of "Client received SOAP Fault from server: The object 'vim.Datastore:datastore-3363' has already been deleted or has not been completely created"

Page viewed 1487 times by 9 users since Sep 28, 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'

VMware vCenter statistic settings

With BVQ version 5.7 it will be possible to scan performance data for VMware objects (virtual machines, ESX hosts, etc.) within BVQ. The following 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 degradations.

 

Information readily available during Scanner installation/Configuration

A scanner needs to be configured for each Storwize/Flash System behind SVC and VMWare environment

In addition to the main scanner configuration for the SVC or Storwize clusters, a scanner should be configured for each backend system that is a Storwize/Flash System

For each Storwize (V7000, V5000, V3700):

-IP address or hostname

-User

-Password

 

Flash System

-IP address or hostname

-user for Flash System (needs to create an FS900 user and pw)

- Password for user of Flash System

 

If installing the VMWare package:

- IP adress or hostname of vCenter

- User Domain of vCenter

-vCenter user and pw (needs to create a vCenter user)

 

Pre installation checklist


 

  • No labels