IBM Wave for z/VM

10/9/2015
1
IBM Inside Sales
International Technical Support Organization Global Content Services
© 2015 IBM CorporationITSO-1
IBM Wave for z/VM and Linux on z
Systems Virtualization

10/9/2015
2
IBM Inside Sales
Introduction
• <<speaker name>>
• <<division>>
• <<city, state, country>>

10/9/2015
3
IBM Inside Sales
The following are trademarks of the International Business Machines Corporation in the United States, other countries, or both.
The following are trademarks or registered trademarks of other companies.
* All other products may be trademarks or registered trademarks of their respective companies.
Notes:
Performance is in Internal Throughput Rate (ITR) ratio based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput that any user will
experience will vary depending upon considerations such as the amount of multiprogramming in the user's job stream, the I/O configuration, the storage configuration, and the workload processed.
Therefore, no assurance can be given that an individual user will achieve throughput improvements equivalent to the performance ratios stated here.
IBM hardware products are manufactured from new parts, or new and serviceable used parts. Regardless, our warranty terms apply.
All customer examples cited or described in this presentation are presented as illustrations of the manner in which some customers have used IBM products and the results they may have achieved. Actual
environmental costs and performance characteristics will vary depending on individual customer configurations and conditions.
This publication was produced in the United States. IBM may not offer the products, services or features discussed in this document in other countries, and the information may be subject to change without
notice. Consult your local IBM business contact for information on the product or services available in your area.
All statements regarding IBM's future direction and intent are subject to change or withdrawal without notice, and represent goals and objectives only.
Information about non-IBM products is obtained from the manufacturers of those products or their published announcements. IBM has not tested those products and cannot confirm the performance,
compatibility, or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
Prices subject to change without notice. Contact your IBM representative or Business Partner for the most current pricing in your geography.
Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.
Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are registered trademarks of Microsoft Corporation in the United States, other countries, or both.
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of
Intel Corporation or its subsidiaries in the United States and other countries.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.
ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office.
IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency, which is now part of the Office of Government Commerce.
For a complete list of IBM Trademarks, see www.ibm.com/legal/copytrade.shtml:
*BladeCenter®, DB2®, e business(logo)®, DataPower®, ESCON, eServer, FICON, IBM®, IBM (logo)®, MVS, OS/390®, POWER6®, POWER6+, POWER7®,
Power Architecture®, PowerVM®, S/390®, System p®, System p5, System x®, System z®, System z9®, System z10®, WebSphere®, X-Architecture®,
zEnterprise, z9®, z10, z/Architecture®, z/OS®, z/VM®, z/VSE®, zSeries®
Not all common law marks used by IBM are listed on this page. Failure of a mark to appear does not mean that IBM does not use the mark nor does it mean that the product is not
actively marketed or is not significant within its relevant market.
Those trademarks followed by ® are registered trademarks of IBM in the United States; all others are trademarks or common law marks of IBM in the United States.
Trademarks
© IBM Corporation, 2015

10/9/2015
4
IBM Inside Sales
What is the ITSO-GCS?
International Technical Support Organization – Global Content
Services
Is the IBM engine for producing and delivering technical content
targeted to the marketplace; making it simpler to understand, faster
and more fun to install and use IBM products solutions and services
– Building a strong, healthy relationship with the marketplace technical community – an
essential element of IBM’s success

10/9/2015
5
IBM Inside Sales
The ITSO webpage: www.redbooks.ibm.com

10/9/2015
6
IBM Inside Sales
Participate in an ITSO residency
Join us for a two- to four-week residency program! Help write a book dealing
with specific products or solutions, while getting hands-on experience with
leading-edge technologies. You will have the opportunity to team with IBM
technical professionals, Business Partners, and Clients.
Your efforts will help increase product acceptance and customer satisfaction.
As bonus, you will develop a network of contacts in IBM development labs,
and increase your productivity and marketability.
Find out more about the residency program, browse the residency index, and
apply online at:
www.ibm.com/redbooks/residencies.html

10/9/2015
7
IBM Inside Sales
Workshop Agenda
Introduction to IBM Wave for z/VM
– Background on IBM Wave
– What is IBM Wave (Solution overview )
– Benefits of using IBM Wave (what can you do with IBM Wave)
• Solution architecture
– High level overview of architecture
• Planning and design tasks
• Installation pre-requisites
• z/VM configuration tasks
• Installation
• Post installation tasks

10/9/2015
8
IBM Inside Sales
Workshop Agenda (cont.)
• Managing z/VM
• Live Guest Relocation
• Managing device pools
• Managing DASD
• Managing the network
• How to manage Linux virtual machines
• Introduction to IBM Wave user interfaces
• IBM Wave administration (site defined groups, projects, golden masters, storage
administration, network administration, adding users)
• IBM Wave operations
8

10/9/2015
9
IBM Inside Sales
IBM Wave for z/VM
IBM Wave for z/VM
Background

10/9/2015
10
IBM Inside Sales
IBM accelerates cloud computing on z Systems with the
acquisition of CSL International
CSL International was a privately held company
headquartered in Hertzelia Pituach, Israel,
They developed the IBM Wave software
product to simplify and automate the
management of z/VM and Linux on z virtual
servers.
IBM Wave:
• Fully abstracts and visualizes the virtual
and physical resources.
• Monitors and manages virtual servers and
resources from a single graphical interface –
essentially turning complex activities into
simple actions.
• Simplifies and Automates day-to-day
tasks.
• Provisions virtual resources
(Guests, Network, Storage).
• Fully supports advanced z/VM capabilities
including Single System Image and Live
Guest Relocation.
The Power of Enterprise Linux made Easy
A strategic investment in the z Systems portfolio, the acquisition deepens our
consolidation and cloud capabilities by offering simplified management
of the virtualization environment.
• Provides direct on-ramp to cloud computing with Linux on
System z.
• Leverages common virtualization skill set allowing clients
to free up experienced staff to address other business
opportunities.
• Combined with the Enterprise Linux Server solution,
provides ground breaking management capabilities with
turn key approach for consolidation and virtualization
solutions.
• Consolidation at scale can help businesses save up to half
the cost of a commodity server environment.

10/9/2015
11
IBM Inside Sales
Introduction to IBM Wave for z/VM
11
Intelligent
Visualization
• Shorten the learning curve
needed to manage complex
environments and reduce
dependency on scarce
technical skills
• Use a consumable
management interface to
help organize and
understand your
environment
• Define and control all
network, storage and
communication devices,
view servers and storage
utilization graphically
• Focus on key resources
using highly customizable
views, reducing
unnecessary steps
Simplified
Monitoring
• Monitor the status of all
controlled z/VM systems
through a single interface
• Monitor performance and
access performance metrics for
CPU, paging devices, spool
disks and more; determine
trends
• Annotate resources for
additional policy based
management
• Employ advanced filters,
tagging, layout and layer
selection for any display
Unified
Management
• Monitor and manage your
system from a single point of
control – CPU, DASD,
networking
• Use an agentless approach
to detect servers, networks,
storage and more
• Provision, clone, and activate
virtual resources instantly
• Perform routine management
tasks like live guest
relocation and executing
scripts with ease
• Assign and delegate
administrative access with
role based assignments

10/9/2015
12
IBM Inside Sales
Feature overview - Automation and simplification
• View the entire server farm laid out graphically
• Ordered Activation/Deactivation of servers
• Execution of customer’s REXX as part of the cloning process to allow local z/VM
customization
• Run Linux shell scripts against dynamically grouped/filtered servers, as IBM
Wave background tasks, listing the results for each selected server - All via the
GUI
• Run REXX EXECs against any virtual object with customized parameters and
results listing - All via the GUI
• WAVECLI – A CLI for IBM Wave actions that can be utilized from Linux shell
scripts or Windows Batch files
• Access Linux guests directly from the GUI using SSH, 3270 or CLC– No
hostnames or IP addresses to remember, simply right-click on the server and
select the desired access
12

10/9/2015
13
IBM Inside Sales
Feature overview - Provisioning
• Sophisticated guests cloning including Cross System Clone
– CSC is the functionality that allows you to clone z/VM virtual guests across IBM Wave
managed z/VM Systems - both across LPARs and CPCs
• Ability to customize the first boot of a cloned server (before TCP/IP is initialized)
• Simple creating and manipulation of Vswitches and Guest LANs
• Connect/disconnect guests to Vswitches or Guest LANs via the GUI
• Storage management and provisioning at the z/VM and Linux levels (including
LVM support)
• Automatic handling of Real or Dedicated devices via IBM Wave’s user defined
Device Pool
13

10/9/2015
14
IBM Inside Sales
Feature overview – Graphical control
• Rich GUI with graphical views of all managed objects
• Advanced filters, tagging, layouts and layers for every display
• Multiple objects may be selected
14

10/9/2015
15
IBM Inside Sales
Feature overview – Auto-detection
• Agentless technology
• Automatic initial detection of all virtual server farms components (servers,
prototypes, networks, network devices and storage)
• Ongoing monitoring of changes made outside of IBM Wave after the initial auto-
detection
15

10/9/2015
16
IBM Inside Sales
Feature overview – Network support
• Centralized, layer based view of the entire network topology per z/VM system
• Define and control all network devices such as VSwitches and guest LANs
• Manipulation of servers-to-network connect/disconnect using GUI
• Support for VLAN usage
• Management of VSwitches with protocol layer 2 or 3
• Customize network topology view with external resources such as routers,
LPARs etc.
16

10/9/2015
17
IBM Inside Sales
IBM Wave for z/VM - Overview
• Graphical management of your z/VM Complex with no limits
on the number of CPCs, z/VM LPARs or SSI clusters.
• Extremely intuitive Point-and-Click and Drag-and-Drop gestures.
• Full abstraction of the underlying z/VM Environment, so Linux System Administrators can be
productive day-one.
• Simplification and automation of all day-to-day tasks
• Provisioning of all virtual entities (Guests, Network and Storage)
• Advanced security architecture to enable delegation of authorities
• Flexible reporting capabilities on all managed entities,
including internal IBM Wave resources
• Comprehensive logging with external integration options
17

10/9/2015
18
IBM Inside Sales
Solution overview
18
• Complete provisioning and management solution for z/VM environment
– Offers provisioning of all aspects of the z/VM hypervisor, including server, network
and storage provisioning
• Gives Linux administrators the freedom to manage their Linux on z
Systems servers without the need to employ a zVM system programmer
for every VM USER environment change needed for their Linux on z
Systems servers
– System administrators do not need to have any knowledge or understanding of the
physical or virtual infrastructure hosting their virtual servers
• Fully abstracts the virtual and physical resources while providing
automation of operating procedures

10/9/2015
19
IBM Inside Sales
21
• zEnterprise: zEC12, zBC12
• Linux on System z
• z/VM 6.3
System z Cloud Ecosystem
IBM
Products &
Offerings
ISV
Solutions
IBM Wave for z/VM
• Provided by CSL International
• Hypervisor manager
• Provides simplified user
interface for z/VM system
programmer tasks.
APPLogic
• Provided by Computer Associates
• Manages both distributed and z/VM
environments.
MOAB
• Provided by Adaptive Computing
• Provides a policy based cloud
management based on xCAT
Integrate Automate Orchestrate
• Tivoli Provisioning Manager
• SmartCloud Entry
• SmartCloud Provisioning
zPRO
• Provided by Velocity Software
• Add-on feature to Velocity’s zVPS
product that provides performance
management
• Provides golden image creation,
cloning, and operational controls
xCAT
• Extreme Cloud Administration Tool
• Now shipped in z/VM 6.3
OpenStack
• Being enabled with z/VM 6.3
• Used as a code base for SmartCloud Entry / Provisioning / Orchestrator
Open
Source
Options
System z support currently in development
• Tivoli Service Automation Manager
• Cloud Ready for Linux on System z
• SmartCloud Orchestrator
IBM acquired CSL-International
New

10/9/2015
20
IBM Inside Sales
With IBM Wave for z/VM this changed dramatically – you can now use and
combine z/VM's virtualization with an intuitive and efficient graphical user
interface that supports Point-and-Click as well as Drog-and-Drop to
perform systems and virtualization management tasks.
For historical reasons the administration and usage of z/VM was cmd-line
based and 3270 (“green-screen”) skills were required. This was often an
inhibitor, specially for new (FIE) customers.
In most environments Linux on System z
runs as a guest (aka virtual machines) on top of z/VM.
Due to the fact that Linux supports and exploits different
architectures, the entire systems have different characteristics.
That means for example different quality of services,
levels of 'RAS' and hypervisors, like IBM z/VM (and PR/SM).
Linux is Linux is Linux is …
The Linux operating systems, for all the different platforms
out there, look and indeed are the same; they share the
same roots and have common source code (kernel.org).
Solution overview...
22

10/9/2015
21
IBM Inside Sales
Administrators and system programmers may work
using 3270 terminal emulation or with IBM Wave interchangeably
– the configuration and state of IBM Wave can be updated
and re-read from the underlying z/VM system.
For an outside-in view of the z/VM hypervisor or the Linux guests
(ie: to get an idea about resources or performance),
Linux administrators no longer need system programmer support
– or at least much less.
With IBM Wave, system programmers are now able to
defer tasks to Linux administrators with limited z/VM skills,
due to the 'role' and 'project' concept that IBM Wave provides.
But the initial setup, as well as the maintenance and upgrade of z/VM still
requires system programmer skills.
Solution Overview (cont.)
IBM Wave for z/VM can be used for day-to-day use of nearly any z/VM.
administration task.
23

10/9/2015
22
IBM Inside Sales
IBM Wave for z/VM provides the graphical interface that simplifies and helps
to automate the management of z/VM and Linux on z Systems virtual
servers.
A simple, intuitive graphical tool providing management, provisioning, and
automation for a z/VM environment, supporting Linux virtual servers.
 Monitors and manages virtual servers
and resources from a single graphical
interface
 Simplifies and Automates tasks
 Provisions virtual resources (Guests,
Network, Storage)
 Supports advanced z/VM capabilities
such as Single System Image and Live
Guest Relocation
 Allows delegation of administrative
capabilities to the appropriate teams

10/9/2015
23
IBM Inside Sales
Key Values
25
IBM Wave for z/VM
• Is a single point of control for z/VM and it's virtual (Linux) machines.
• Offers system-, virtualization- and network-management,
and more administration functionalities – so basic Cloud management.
• Includes essential functionalities for the provisioning and automation of
tasks.
• Contains basic monitoring capabilities and can further integrate with z/VM
Performance Toolkit.
• Offers an easy, convenient, efficient and modern Java Web-Start based
graphical user interface, supporting Windows clients.

10/9/2015
24
IBM Inside Sales
Key Values
26
IBM Wave for z/VM
• Is more efficient with just a few clicks – instead of lot's of 3270 commands.
• Provides a flat learning curve to z/VM administration skills and helps to
overcome the z Systems and specially the z/VM skill barrier.
• With IBM Wave, the efficiency of a System z machine and it's z/VM
hypervisor finally reaches the administration interface.

10/9/2015
25
IBM Inside Sales
Benefits of using IBM Wave for z/VM
• Most actions can be carried out against multiple objects whether they are on a
single or multiple LPARs.
• Intelligent icons help the user understand the status of the system and its
resources. For example an icon can indicate whether a virtual guest is running,
whether it is running a Linux distribution from Suse or Red Hat, or whether it is a
CMS guest, a system service machine or a IBM Wave for z/VM internal virtual
server.
• Definition and use of functionality types ensures ordered activation and
deactivation of z/VM guests. For example, a database server can be brought up
followed by a transaction server and a web server with deactivation occurring in
the reverse order.

10/9/2015
26
IBM Inside Sales
• Ability to broadcast a message to a set of Linux users. This can be finely filtered
with the use of custom attributes.
• Intelligent Active Notes (IANs) allow free form text to be associated with an
object and displayed during a mouse hover. Initiating an action on the object
causes the IAN to pop up.
• At a glance views of overall system storage utilization with the ability to drill
down to the volume level for site level administrators and for Linux
administrators views of storage groups to which they are uniquely permitted.
• Simplified mechanism of storage assignment and storage management allowing
the IBM Wave user to interact with DASD Volumes, DASD Groups and
DIRMAINT regions

10/9/2015
27
IBM Inside Sales
• Performance view of all managed systems includes current CPU utilization,
page and spool space and virtual to real storage ratios. Drill down to the Linux
guest level is also supported.
• Generate concise reports for selected objects with the ability to use complex
filters and customization.
• Custom attributes and their associated values can be defined and associated
with virtual guests. Multiple attributes can be assigned to guests and then used
for grouping and filtering in any combination to take action on a set of guests.
For example, an attribute called Server Use could be defined with possible
values Production, QA, Development.

10/9/2015
28
IBM Inside Sales
IBM Wave for z/VM
Architectural overview

10/9/2015
29
IBM Inside Sales
IBM Wave for z/VM Architectural Overview
31
The GUI Client
The GUI Client must run on
an Windows client. It
provides a graphic
interpretation of the
knowledgebase and allows
the user to interact with the
TVP using Point-and-Click
and Drag-and-Drop
operations.
The BTS (WAVESRV)
This server can be a
physical or virtual one and
hosts the application
database, web server and
BTS (Background Task
Scheduler). There is no
limitation on the number of
TVPs or virtual guests that
one BTS server can
manage.
The TVP
The Target Virtualization
Platform (TVP) represents
the hypervisor which hosts
the virtual guests. The BTS
and the GUI Clients utilize
the TVP API to query and
perform changes to the
TVP and hosted virtual
guests.

10/9/2015
30
IBM Inside Sales
IBM Wave for z/VM: Tier 1- GUI
32

10/9/2015
31
IBM Inside Sales
IBM Wave for z/VM: Tier 2 – WAVESRV server
33
z/VM LPAR API Server
WAVESRV Server
Background Task
Scheduler (BTS)
IBM Wave for
z/VM
database
IBM Wave for z/VM
GUI client
IBM Wave for
z/VM
web server

10/9/2015
32
IBM Inside Sales
Tier 2: The WAVESRV server: Knowledgebase
MySQL database which contains information on:
• All z/VM elements managed by IBM Wave
• IBM Wave regular log
• Objects managed by IBM Wave for z/VM:
– CPCs
– z/VMs
– Linux on z Systems virtual servers and their z/VM guests
– Virtual networks and their connections’ definitions
– Prototypes
– Logs
– Users
– Projects
– Storage grouops
– Disks and their attributes
– Directory records
34

10/9/2015
33
IBM Inside Sales
Tier 2: The WAVESRV server: Background Task Scheduler
(BTS)
• Updates with live data
• GUI client gets its information from the IBM Wave database
• Handles requests using worker threads
– User worker threads: Responsible for running user-generated BTS Workunits and
Requests. This is a configurable option. To determine the number of User Worker
Threads, use the following formula:
<Number of concurrent IBM Wave Users>*2 + <Number of concurrent clone operations>*<maximum of minidisks in a
source guest for cloning>
– Internal worker threads: Responsible for running the internal IBM Wave Workunits and
Requests such as the periodic tasks. This is not customizable and is determined by the
number of z/VM systems managed by the BTS.
35

10/9/2015
34
IBM Inside Sales
(BTS)
• Every request is run under a BTS Work Unit.
• All output generated by the BTS and all BTS requests are stored in the COR
36

10/9/2015
35
IBM Inside Sales
(BTS)
• Each BTS request is allocated at least one COR entry
37

10/9/2015
36
IBM Inside Sales
(BTS)
• Some scheduling intervals
can be changed in the IBM
Wave parameters panel
– Log dump interval
– Workunit Sampling
– Relocation sampling
– Etc
• The scheduling requests:
– Monitor the status of internal
IBM Wave components such
as the IBM Wave service
machines and the WAVESRV
file system. They also clean
the BTS work units that have
expired
– Update the IBM Wave
knowledgebase with
information from the managed
38

10/9/2015
37
IBM Inside Sales
IBM Wave for z/VM WAVESRV server foundation
40
 Background Task Scheduler (BTS)
– Employs Work Unit processing architecture for BTS worker threads
 Knowledge Base
– Keeps track of the managed system components and their associated metadata
 Common Output Repository (COR)
– Stores output generated by each BTS work unit
 Message Brokers
– Efficiently moves messages across all system components
 Security Enforcer
– Controls the scope and permission of every user action
 Device Management
– Simple and automatic control of all virtual and real/dedicated devices

10/9/2015
38
IBM Inside Sales
IBM Wave for z/VM: Tier 3 – Target Virtualization Platform (TVP)
41

10/9/2015
39
IBM Inside Sales
IBM Wave for z/VM Target Virtualization Platform (TVP)
42
 IBM Wave utilizes the SMAPI interface in order to mediate requests from the BTS
and the GUI Client.
 Specific functions executed on the z/VM System using the following Service
Machines:
 WAVEWRKS
- The Short Service Machine executes various compiled REXX EXECs to
interact with the z/VM environment.
 WAVEWRKL
- The Long Service Machine provides an additional thread of execution to run longer
scripts or executes some directory manager commands.
 WAVEWRKC
- This Cross-System Cloning Service Machine is used to stream minidisks from a
source z/VM system to a target z/VM system during cloning actions.
 As part of the auto-detection process when adding a new z/VM System to IBM
Wave management, these 3 service machines are created and started on the
z/VM System automatically.

10/9/2015
40
IBM Inside Sales
GUI Client
zLinux : WAVESRV
zVM : TVP API
IBM Wave Operational Model
Repository DB
IBM Wave BTS
Service Machines
WAVEWRKS
REXX/CP/CMS
cmd
Dirmaint
cmd
Cross System
Cloning
WAVEWRKL WAVEWRKC
WebServer
Management
Provisioning
Operation
Automation
JAVA
WebStart
App
Elements
Objects
Users
Log
• Elements
• Objects
• Users
• Log
• Physical Servers
• z/VM instances, Virtual Linux Server Objects
• Virtual Networks (Guest LANs/VSwitches)
• Virtual-servers-to-Virtual Networks Connections
• Storage Volumes/Groups
Scope
• WAVEWRKS – REXX executables, CP/CMS
commands
• WAVEWRKL – Directory Manager commands
• WAVEWRKC – Cross System Clone feature

10/9/2015
41
IBM Inside Sales
IBM Wave for z/VM
Planning and Design

10/9/2015
42
IBM Inside Sales
Planning and Design
45
 Sizing
 1,5 GB RAM
 Filesystems:
• /boot 100MB
• / 3GB
• /var 3GB
 Sizing the log space areas
• By default, logs are stored in /var
• configure the /var filesystem as a logical volume under LVM so it
can be extended when needed.

10/9/2015
43
IBM Inside Sales
Planning and Design
• The WAVESRV Linux system runs either as a z/VM guest or native in a
dedicated Linux partition on PR/SM™.
• The most current Wave software level is IBM-Wave-1.2.0.00.5 (1.2.5).
• It requires Red Hat Enterprise Linux Version 6 (RHEL 6) or SUSE Linux
Enterprise Server 11 (SLES 11)
• It requires Java SE Runtime 1.7 or later, MySQL V12.22 or later and Apache to
be installed.

10/9/2015
44
IBM Inside Sales
Sample directory entry for the WAVESRV virtual server
*****************************************************************
USER WAVESRV <Password Here> 2G 4G GC
CPU 00
IPL 150
MACHINE ESA 4
OPTION QUICKDSP
SET RUN ON
CONSOLE 0009 3215
NICDEF 0800 TYPE QDIO LAN SYSTEM <GLAN/VSWITCH Name here>
SPOOL 000C 3505 A
SPOOL 000D 3525 A
SPOOL 000E 1403 A
LINK MAINT 0190 0190 RR
LINK MAINT 019D 019D RR
LINK MAINT 019E 019E RR
MDISK 0191 3390 1 3 <DASD Volume Name here> - This is a CMS minidisk
MDISK 0150 3390 1 3000 <DASD Volume Name here> - This minidisk will be used for
„/‟
„/var‟
swap
*****************************************************************
47

10/9/2015
45
IBM Inside Sales
Sample directory entry for the WAVESRV virtual server
48

10/9/2015
46
IBM Inside Sales
Planning and Design for SSI cluster
• The WAVESRV Linux system runs only in one SSI member and is defined as a
single-configuration virtual machine (USER) which allows to relocate the
WAVESRV guest system in the SSI cluster.
• The Wave Service Machines require a different setup. Wave Service Machines
need to run in every SSI member that needs to be managed by Wave.
• There are two possible setup scenario’s.

10/9/2015
47
IBM Inside Sales
• The first is to use the same name and definition for the service machines on
each member of the SSI cluster.
• This configuration however requires a lot of manual definitions. You need to
create Identities for each service machine on each member of the cluster.

10/9/2015
48
IBM Inside Sales

10/9/2015
49
IBM Inside Sales
• The second scenario defines different Wave Service Machines with different
names on every member of the SSI cluster.
• The advantage is that you do not need to define any identities and let Wave
define all the service machines during the Autodetect step.

10/9/2015
50
IBM Inside Sales

10/9/2015
51
IBM Inside Sales
Planning and Design for Installations with ESM
• If the environment is not protected by RACF or other security facilities, Wave
creates all Wave Service Machines in the Autodetect Step automatically.
• In a “protected” environment, those service machines have to be pre-defined
and autorized. Wave will then detect them in the Autodetect Step and will skip
the creation of the service machines.
• UserID’s need to be pre-defined and access to mini disks need to be granted.
• The first is to use the same name and definition for the service machines on
each member of the SSI cluster.
• This configuration however requires a lot of manual definitions. You need to
create Identities for each service machine on each member of the cluster.

10/9/2015
52
IBM Inside Sales
Planning and Design
The following prerequisites must be met on every workstation running the IBM
Wave GUI client:
• MicrosoftTM WindowsTM with JavaTM V1.7 installed (64-bit installation is
recommended)
• Firefox or Internet Explorer
• PuTTY or equivalent telnet/SSH client

10/9/2015
53
IBM Inside Sales
IBM Wave for z/VM
Installation pre-
requisites

10/9/2015
54
IBM Inside Sales
Pre-installation tasks
• In order to successfully install IBM Wave for z/VM it is necessary to make sure
you have all of the prerequisite software installed and configured on z/VM and
the Linux system that will be used as the wave server.
• The following slides list pre-requisite software and walk through pre-installation
configuration tasks.
57

10/9/2015
55
IBM Inside Sales
58

10/9/2015
56
IBM Inside Sales
Managed Linux System pre-requisites
For every Linux on System z virtual machine managed by IBM Wave for z/VM:
• SSH, VMCP and CMSFS (if using SUSE Linux Enterprise Server) packages
must be installed.
59

10/9/2015
57
IBM Inside Sales
Pre-installation configuration tasks for z/VM
Before installing the IBM-WAVE for z/VM rpm into the WAVESRV system some
configuration tasks needs to be finished in the following products.
• z/VM System Management API (SMAPI)
• DIRMAINT
• TCP/IP for z/VM
• Performance Toolkit (Optional)
• ESM like RACF
60

10/9/2015
58
IBM Inside Sales
z/VM System Management API (SMAPI)
• IBM-WAVE uses SMAPI to accomplish various tasks on the z/VM system. It is
therefore necessary to make sure that the SMAPI is configured and running
prior to the installation of IBM-WAVE.
• The exact configuration steps for SMAPI differ based up on the version and
release level of z/VM. We show in this presentation the configuration steps for
z/VM 6.3
61

10/9/2015
59
IBM Inside Sales
• Modify the DMSSISVR NAMES file to uncomment the directory manager
definition, and the dump handler definition. Since DMSSISVR NAMES is a
replacement maintained part, it is recommended to use the VMSES/E localmod
procedure to make changes to this file.
• From the MAINT630 userid enter:
LOCALMOD CMS DMSSISVR NAMES
• Enter 1 when prompted to continue. The system will respond by placing you in
an XEDIT session on the file DMSSISVR NAMES
62

10/9/2015
60
IBM Inside Sales
• Scroll to the lines containing:
*:server.DIRMAINT
*:type.DMGR
• Modify the lines to contain:
:server.DIRMAINT
:type.DMGR
63

10/9/2015
61
IBM Inside Sales
• Scroll to the lines containing:
* Dump Handler
*:server.OPERATNS
*:type.WORKER
*:short.DMPH
• Modify the lines to contain:
* Dump Handler
:server.OPERATNS
:type.WORKER
:short.DMPH
64

10/9/2015
62
IBM Inside Sales
• File these changes. The system will create a DMSSISVR NAML0002 file on
the CMS localmod minidisk (MAINT630 3C4).
• Enter the following command to rebuild the file including the new
modification:
SERVICE CMS BUILD
• Enter the following command to move the new DMSSISVR NAMES file from
the alternate build disk to the runtime disk (MAINT 193):
PUT2PROD
In an SSI environment PUT2PROD must run in all SSI members.
65

10/9/2015
63
IBM Inside Sales
• Since many the SMAPI calls are carried out by the directory manager virtual
machine (DIRMAINT) it is necessary to authorize the SMAPI worker virtual
machines to use DIRMAINT. This configuration work can be done from the
MAINT630 userid.
• When you configured DIRMAINT for use you would have created a
configuration override file to make changes to the IBM supplied CONFIG
DATADVH file. On our system we named that file CONFIGAA DATADVH.
• Enter the following command for DIRMAINT to send you the config file:
DIRM SEND CONFIGAA DATADVH
66

10/9/2015
64
IBM Inside Sales
• Receive the spool file sent by DIRMAINT using the CMS RECEIVE
command. This will place the config file on the MAINT630 191 minidisk.
• Use XEDIT to modify the file by adding the following lines:
ALLOW_ASUSER_NOPASS_FROM= VSMGUARD *
ALLOW_ASUSER_NOPASS_FROM= VSMWORK1 *
ALLOW_ASUSER_NOPASS_FROM= WAVEWRKS *
ALLOW_ASUSER_NOPASS_FROM= WAVEWRKC *
ALLOW_ASUSER_NOPASS_FROM= WAVEWRKL *
ASYNCHRONOUS_UPDATE_NOTIFICATION_EXIT.TCP=DVHXNE EXEC
ASYNCHRONOUS_UPDATE_NOTIFICATION_EXIT.UDP=DVHXNE EXEC
• File the changes
67

10/9/2015
65
IBM Inside Sales
 If you did not activate DATAMOVE when you originally configured
DIRMAINT for use, you should do so now as IBM Wave for z/VM requires
that the DATAMOVE function be available.
 The statements to add to CONFIGAA DATADVH are as follows:
DISK_CLEANUP= YES
DATAMOVE_MACHINE= DATAMOVE * *
 File the changes.
68

10/9/2015
66
IBM Inside Sales
• Use the following commands to send the modified file back to DIRMAINT and
to cause DIRMAINT to reprocess the contents of the file:
DIRM FILE CONFIGAA DATADVH A
DIRM RLDDATA
DIRM RLDCODE
69

10/9/2015
67
IBM Inside Sales
• Use the following command to cause DIRMAINT to send you the AUTHFOR
CONTROL file:
DIRM SEND AUTHFOR CONTROL
• Receive the spool file sent by DIRMAINT using the CMS RECEIVE
command. This will place the config file on the MAINT630 191 minidisk.
70

10/9/2015
68
IBM Inside Sales
• Use XEDIT to modify the file by adding the following lines:
ALL VSMGUARD * 140A ADGHMOPS
ALL VSMGUARD * 150A ADGHMOPS
ALL VSMWORK1 * 140A ADGHMOPS
ALL WAVEWRKS * 140A ADGHMOPSZ
ALL WAVEWRKS * 150A ADGHMOPSZ
ALL WAVEWRKL * 140A ADGHMOPSZ
ALL WAVEWRKL * 150A ADGHMOPSZ
ALL WAVEWRKC * 140A ADGHMOPSZ
ALL WAVEWRKC * 150A ADGHMOPSZ
• File the changes.
71

10/9/2015
69
IBM Inside Sales
• Use the following command to send the modified AUTHFOR CONTROL file
back to DIRMAINT and to cause DIRMAINT to reprocess the content of the
changed file:
DIRM FILE AUTHFOR CONTROL A
DIRM RLDDATA
DIRM RLDCODE
72

10/9/2015
70
IBM Inside Sales
You can ensure that your AUTHFOR updates completed properly by running
the
DIRMAINT command:
DIRM FOR ALL AUTHFOR ?
 The command response should show that VSMGUARD, VSMWORK1 - 3
and WAVEWRKS, WAVEWRKL, and WAVEWRKC are all authorized.
73

10/9/2015
71
IBM Inside Sales
• When IBM Wave for z/VM uses the SMAPI it must authenticate using an
existing z/VM virtual machine name and password. The virtual machine used
does not need any special privilege classes, and will never be logged on. It
simply needs to be defined in the z/VM USER DIRECTORY for
authentication purposes.
• The SMAPI authorized users file is named VSMWORK1 AUTHLIST, and it is
located in the VMSYS: filepool under the root directory for VSMWORK1
(VMSYS:VSMWORK1.).
74

10/9/2015
72
IBM Inside Sales
• Care needs to be taken when updating this file. The default file that comes
with z/VM 6.3 has the following data in it:
DO.NOT.REMOVE DO.NOT.REMOVE
MAINT ALL
ZHCP ALL
• For this system, we simply used the MAINT userid for authorization within
IBM Wave. If you would like to add a new userid to the file it is recommended
that you copy an existing line, and then only overtype the userid text on the
duplicated line.
75

10/9/2015
73
IBM Inside Sales
DIRMAINT
 To support IBM Wave for z/VM, the DIRMAINT virtual machine must run with
the C and E PRIVCLASSes added to the default of BD and G. The following
command will add privclasses C and E to the DIRMAINT virtual machine:
DIRM FOR DIRMAINT PRIV +CE
 The new privilege classes will not take effect until the DIRMAINT virtual
machine is logged off and logged back on.
76

10/9/2015
74
IBM Inside Sales
DIRMAINT
 Since IBM Wave for z/VM will be allocating DASD space it is necessary to
configure the DIRMAINT EXTENT CONTROL file before installing IBM Wave
for z/VM.
 At a minimum you should have one region defined.
 When IBM Wave for z/VM is installed, a dummy region of one cylinder will be
created as a placeholder for “empty” storage groups.
 If you have already updated EXTENT CONTROL to add regions and groups,
you may use one of your already allocated regions.
77

10/9/2015
75
IBM Inside Sales
DIRMAINT
 To double check the region name and volume name you will use during IBM
Wave for z/VM install you may want to execute the following commands
and see that a return code of zero is returned.
DIRM DASD QUERY REGION LX9220
DIRM DASD QUERY VOLUME LX9220
 We used region name and volume name LX9220. You will need to
substitute a value for LX9220 that matches information in your EXTENT
CONTROL file.
78

10/9/2015
76
IBM Inside Sales
TCP/IP for z/VM
 Since IBM Wave for z/VM has the capability to establish 3270 sessions
from within the WAVE GUI it is necessary to update the PROFILE TCPIP
file for the z/VM TCP/IP stack to authorize two of the WAVE worker
machines to use the obeyfile command.
 The PROFILE TCPIP file is by default created on the TCPMAINT virtual
machine’s 198 minidisk. Add the following virtual machines to the OBEY
section of that file:
OBEY
OPERATOR TCPMAINT MAINT MPROUTE REXECD SNMPD SNMPQE
LDAPSRV MAINT630
WAVEWRKS WAVEWRKL
ENDOBEY
79

10/9/2015
77
IBM Inside Sales
TCP/IP for z/VM
 You will also want to make sure that the PORT section of your PROFILE
TCPIP contains the following uncommented lines:
PORT
20 TCP FTPSERVE NOAUTOLOG ; FTP Server
21 TCP FTPSERVE ; FTP Server
23 TCP INTCLIEN ; TELNET Server
80

10/9/2015
78
IBM Inside Sales
TCP/IP for z/VM
 Lastly make sure that the FTPSERVE virtual machine is automatically
started by TCPIP. You should see an AUTOLOG section similar to this:
AUTOLOG
FTPSERVE X
ENDAUTOLOG
 After making changes to the PROFILE TCPIP file, you will need to restart
your TCPIP virtual machine to pick up these changes.
81

10/9/2015
79
IBM Inside Sales
Performance Toolkit
 If the Performance Toolkit is available, then IBM Wave for z/VM will use this
feature to display performance information for individual virtual machines.
 In order for IBM Wave for z/VM to be able to use Performance Toolkit, the
short duration worker machine (WAVEWRKS) needs to be authorized to
gather data from Performance Toolkit.
 This is accomplished by adding WAVEWRKS to the FCONRMT AUTHORIZ
file maintained on the 191 minidisk of the PERFSVM virtual machine.
82

10/9/2015
80
IBM Inside Sales
Performance Toolkit
 Update the FCONRMT AUTHORIZ file with the following entry:
WAVEWRKS * DATA CMD
 IBM Wave for z/VM general requirements for Performance Toolkit include
making sure that the VMCF interface is turned on. This is accomplished by
uncommenting the FC MONCOLL VMCF ON statement in the FCONRMT
$PROFILE.
83

10/9/2015
81
IBM Inside Sales
Performance Toolkit
 It is also necessary for the CP Monitor to be configured for collection of
sample records from the processor, storage and user (all) domains. This is
accomplished by making certain that the PROFILE EXEC for PERFSVM has
the following commands uncommented:
'CP MONITOR SAMPLE ENABLE PROCESSOR'
'CP MONITOR SAMPLE ENABLE STORAGE'
'CP MONITOR SAMPLE ENABLE USER ALL'
84

10/9/2015
82
IBM Inside Sales
Performance Toolkit
 These configuration steps are commonly done when setting Performance
Toolkit up for general system use.
 It is good however to review the FCONRMT PROFILE and PERFSVM
PROFILE EXEC to make certain the necessary configuration steps have
been completed.
85

10/9/2015
83
IBM Inside Sales
Configure SMAPI to work with RACF
• Log on to MAINT on the first SSI member.
• Allow VSMWORK1 to have CONTROL authority the z/VM minidisk (VMMDISK)
that contains the SYSTEM CONFIG file (PMAINT CF0), perform the following
command:
RAC PERMIT PMAINT.CF0 CLASS(VMMDISK) ACC(CONTROL) ID(VSMWORK1)
RAC PERMIT MAINT.CF1 CLASS(VMMDISK) ACC(CONTROL) ID(VSMWORK1)

10/9/2015
84
IBM Inside Sales
• Allow VSMWORK1 to have CONTROL access to the generic class VMBATCH:
RAC PERMIT ** class(vmbatch) id(vsmwork1) access(control)
• Allow SMAPI workers to read the TCPMAINT 198 disk:
RAC PERMIT tcpmaint.198 class(vmmdisk) acc(read) id(vsmguard)
RAC PERMIT tcpmaint.198 class(vmmdisk) acc(read) id(vsmwork1)
• Change default password expiration to your security standard; 186 days in this
example:
RAC setropts password(interval(186))

10/9/2015
85
IBM Inside Sales
• Enable the SMAPI service machines VSMREQI6, VSMREQIN, VSMREQIU,
VSMEVSRV, DTCSMAPI, VSMWORK1, VSMWORK2, and VSMWORK3 to use
RACROUTE services with the following commands:
RAC SETROPTS CLASSACT(FACILITY)
RAC RDEFINE FACILITY ICHCONN UACC(NONE)
RAC PERMIT ICHCONN CLASS(FACILITY) ID(VSMREQI6) ACCESS(UPDATE)
RAC PERMIT ICHCONN CLASS(FACILITY) ID(VSMREQIN) ACCESS(UPDATE)
RAC PERMIT ICHCONN CLASS(FACILITY) ID(VSMREQIU) ACCESS(UPDATE)
RAC PERMIT ICHCONN CLASS(FACILITY) ID(VSMEVSRV) ACCESS(UPDATE)
RAC PERMIT ICHCONN CLASS(FACILITY) ID(DTCSMAPI) ACCESS(UPDATE)
RAC PERMIT ICHCONN CLASS(FACILITY) ID(VSMWORK1) ACCESS(UPDATE)
RAC SETROPTS RACLIST(FACILITY)

10/9/2015
86
IBM Inside Sales
• Make the DTCSMAPI, VSMWORK1, VSMWORK2, VSMWORK3 virtual
machines exempt with the following commands:
RAC SETROPTS CLASSACT(VMXEVENT)
RAC RDEFINE VMXEVENT USERSEL.DTCSMAPI
RAC RALTER VMXEVENT USERSEL.DTCSMAPI ADDMEM(FOR.C/NOCTL)
RAC RALTER VMXEVENT USERSEL.DTCSMAPI ADDMEM(LINK/NOCTL)
RAC SETEVENT REFRESH USERSEL.DTCSMAPI
(commands only shown for DTCSMAPI)

10/9/2015
87
IBM Inside Sales
Configure IBM WAVE to work with RACF
• Perform the following steps to allow WAVE to work with RACF after you defined
the Wave Service Machines as Identities.
• Because the Service Machines are populated by auto detect, you must grant all
the necessary RACF permissions here before you attempt to auto detect the
system.
• Set the passwords for the three IBM Wave Service Machines with your true
password:
RAC ALU WAVEWRKS PASS(PASSWORD) NOEXP
RAC ALU WAVEWRKL PASS(PASSWORD) NOEXP
RAC ALU WAVEWRKC PASS(PASSWORD) NOEXP

10/9/2015
88
IBM Inside Sales
IBM Wave for z/VM
Installation

10/9/2015
89
IBM Inside Sales
Installation
• Simple Install process using a single RPM
• The RPM-Install does the following:
– Configures database
– Configures webserver
– Configures NFS
– Creates Linux user, certificates
– Installs BTS as Service
– Starts up all components
– Builds CLI packages

10/9/2015
90
IBM Inside Sales
Installation
IBM Wave 1.1.0 Base Installation

10/9/2015
91
IBM Inside Sales
Installation
IBM Wave 1.1.0 Base Installation

10/9/2015
92
IBM Inside Sales
Installation Verification
• WAVESERV
– Make sure the BTS is up and running
• Post installation Tasks:
– Managed z/VM Systems
– Use z/VM API Testing Application which verifies:
– Directory Manager is up and running
– SMAPI Request and Worker machines are up and running
– SMAPI can communicate with Directory Manager
– Authorized User is set up OK

10/9/2015
93
IBM Inside Sales
IBM Wave for z/VM
Introduction to the User
Interface

10/9/2015
94
IBM Inside Sales
Launch the z/VM API testing application
97
Once the IBM Wave rpm is installed on the WAVESRV virtual machine and
running it is possible to access the API test Java application from the IBM Wave
for z/VM web page.

10/9/2015
95
IBM Inside Sales
Launch the z/VM API testing application
98

10/9/2015
96
IBM Inside Sales
z/VM API testing application
99

10/9/2015
97
IBM Inside Sales
100

10/9/2015
98
IBM Inside Sales
101

10/9/2015
99
IBM Inside Sales
Launch IBM Wave
102

10/9/2015
100
IBM Inside Sales
Launch IBM Wave
103

10/9/2015
101
IBM Inside Sales
Launch IBM Wave
104

10/9/2015
102
IBM Inside Sales
First log in – define an administrator
105

10/9/2015
103
IBM Inside Sales
Login to IBM Wave
106

10/9/2015
104
IBM Inside Sales
Login to IBM Wave
107

10/9/2015
105
IBM Inside Sales
Main display panel
108

10/9/2015
106
IBM Inside Sales
Adding a new central processor complex
• Now that IBM Wave for z/VM is installed, the next task is to define a central
processor complex (CPC) that hosts a z/VM system to be managed.
Complete the following steps:
• On the main display, right-click inside the hardware viewer panel. You see the
Add New CPC option

10/9/2015
107
IBM Inside Sales
• Click Add New CPC. A panel opens in which you can enter information about
the new CPC:
Enter the name of the CPC, the CPC Model from the CPC Model drop-
down menu, the CPU serial number and the description of the system.
Then click on Create

10/9/2015
108
IBM Inside Sales
• If no errors are encountered, a success message opens:
Click OK and you return to the main display. A graphic that represents the
CPC that was added is shown in the hardware viewer section of the main
display.

10/9/2015
109
IBM Inside Sales
Hardware viewer with the new
defined CPC.

10/9/2015
110
IBM Inside Sales
Define New z/VM Systems
• To define a z/VM system on the new CPC for IBM Wave for z/VM to manage,
an external managed entity must be created for this system. Complete the
following steps:
From the main display, click Administration at the top of the display, then
select Site Management, and External Entities Manager.

10/9/2015
111
IBM Inside Sales

10/9/2015
112
IBM Inside Sales
• A window opens that lists any external entities that are defined. Because we
did not yet define any entities, the panel is blank.
Click Create IBM Wave External Entity to add a new entity to IBM Wave.
A window opens in which you enter the name and type of entity that is added

10/9/2015
113
IBM Inside Sales
Enter the name of the LPAR that you want IBM Wave for z/VM to manage. In
this example, we use VMLINUX2 as the name of the entity, and then select
z/VM as the type from the drop-down menu. Add a description in the
Description field (in this example, ITSO System). After clicking on Create the
new entity will be added and the result is shown in the right picture.

10/9/2015
114
IBM Inside Sales
• Now that a type z/VM external entity is created, a new z/VM system for IBM
Wave can be added for z/VM to manage. This task is done by selecting CPC
in the hardware viewer and then right-clicking it. Select More Actions → Add
New System

10/9/2015
115
IBM Inside Sales
• A window opens in which you enter information about the new z/VM system to
be managed.

10/9/2015
116
IBM Inside Sales
• The Add New System Panel opens
with some of the information
already entered. The System
Name and CPC Name were taken
from External Entity definition and
CPC Object. The IBM Wave
Service Machine Information
contains typical defaults. After
adding the other information click
on Create:

10/9/2015
117
IBM Inside Sales
• The Auto Detect process is where IBM Wave for z/VM creates the worker
machines and then discovers as much information as possible from the z/VM
system. Information that is discovered consists of all of the defined virtual
machines, DASD information, networking information, and so on.
• To start the Auto Detect process, click Next. A window opens in which you
enter the user name and password of the Authorized API User. (This is a user
name that is defined in the VSMWORK1 AUTHLIST file).
• Fill in the necessary information in the next panels for the Auto Detect
process.

10/9/2015
118
IBM Inside Sales
Auto Detect Wizard Step 1 Start

10/9/2015
119
IBM Inside Sales
Auto Detect Wizard Step 2 Authorized API User

10/9/2015
120
IBM Inside Sales
Auto Detect Wizard Step 3 Service Machines

10/9/2015
121
IBM Inside Sales
Auto Detect Wizard Step 4 Device Pools

10/9/2015
122
IBM Inside Sales
Auto Detect Wizard Step 5 Additional Parameters

10/9/2015
123
IBM Inside Sales
Auto Detect Wizard Step 6 Summary

10/9/2015
124
IBM Inside Sales
Auto Detect Wizard Step 6 Summary
Because IBM Wave uses the long duration IBM Wave service machine
(WAVEWRKL) to create the Dummy Region, this warning reminds you
that the IBM Wave service machines must be authorized with DIRMAINT
to run commands such as this command

10/9/2015
125
IBM Inside Sales
As the auto detect process runs, a BTS Work Unit shows a progress bar in the
IBM Wave viewers section of the main display:

10/9/2015
126
IBM Inside Sales
Details that are associated with this work unit can be viewed by double-clicking
the row in the table under the BTS Work Unit tab. A Work Unit Details window
opens:

10/9/2015
127
IBM Inside Sales
When the auto detect work unit completes, the system might still be processing
the data that was gathered. A progress message is updated in the system viewer
portion of the main display:

10/9/2015
128
IBM Inside Sales
When all of the queued update events are processed, the z/VM groups are
displayed for the current system (VMLINUX2):

10/9/2015
129
IBM Inside Sales
One last task to complete after the installation is to mark the WAVESRV virtual
machine as an IBM Wave service machine.

10/9/2015
130
IBM Inside Sales
Expanding the WAVE-INTERNAL group icon shows that the WAVESRV virtual
machine is now part of that group:

10/9/2015
131
IBM Inside Sales
z/VM environment viewers
Menu BarTitle Bar Tool Bar
IBM Wave viewer
z/VM environment viewers
Status Bar

10/9/2015
132
IBM Inside Sales
The Title Bar
135
The Title Bar contains basic information about the IBM Wave server and buttons to
manipulate the primary IBM Wave Window
From left to right, the Title Bar contains:
• The IBM Wave icon
• The version of IBM Wave
• The hostname of the server running IBM Wave
• The IP address of the server running IBM Wave
• The minimize, maximize, and close window buttons (not shown here)

10/9/2015
133
IBM Inside Sales
The Menu Bar
136
• The Menu Bar contains a variety of drop-down submenus that contain a variety
of functions.
• While the large number of submenus may look intimidating, many of these
menus contain only one function.
• Additionally, most of these functions can be accessed through other means,
such as the Tool Bar or context menus in various Viewers

10/9/2015
134
IBM Inside Sales
Submenu - File
137

10/9/2015
135
IBM Inside Sales
Submenu – Auto Detect
138

10/9/2015
136
IBM Inside Sales
Submenu – User-Group Management
139

10/9/2015
137
IBM Inside Sales
Site defined groups
140

10/9/2015
138
IBM Inside Sales
Submenu - Network Management, Prototype, and Storage
Management Submenus
141

10/9/2015
139
IBM Inside Sales
Submenu - Administrative
142

10/9/2015
140
IBM Inside Sales
Project management
143

10/9/2015
141
IBM Inside Sales
Project management
144

10/9/2015
142
IBM Inside Sales
Project management
145

10/9/2015
143
IBM Inside Sales
Submenu – Site Management
146

10/9/2015
144
IBM Inside Sales
Submenu – User Tasks
147

10/9/2015
145
IBM Inside Sales
Submenu – Report Manager  to be updated
148

10/9/2015
146
IBM Inside Sales
Submenu - Window
149

10/9/2015
147
IBM Inside Sales
Submenu - Help
150

10/9/2015
148
IBM Inside Sales
Submenu – The Tool Bar
151

10/9/2015
149
IBM Inside Sales
The z/VM viewers
152

10/9/2015
150
IBM Inside Sales
Hardware Viewer
153
Single CPC Two CPCs – one is an SSI cluster

10/9/2015
151
IBM Inside Sales
Current System view
154

10/9/2015
152
IBM Inside Sales
z/VM User Groups Tab
155

10/9/2015
153
IBM Inside Sales
Network Tab
156

10/9/2015
154
IBM Inside Sales
Prototypes Tab
157

10/9/2015
155
IBM Inside Sales
Storage Tab - Distribution
158

10/9/2015
156
IBM Inside Sales
Storage Tab - Groups
159

10/9/2015
157
IBM Inside Sales
Storage Tab - Volumes
160
The second storage view is Volumes, which shows actual DASD volumes. Because a typical z/VM environment has far too many DASD volumes to be effectively

10/9/2015
158
IBM Inside Sales
System Status Tab
161

10/9/2015
159
IBM Inside Sales
Session Tasks Tab
162

10/9/2015
160
IBM Inside Sales
Enterprise Viewer
163

10/9/2015
161
IBM Inside Sales
Dashboard viewer
164

10/9/2015
162
IBM Inside Sales
Dashboard viewer
165

10/9/2015
163
IBM Inside Sales
IBM Wave viewer
166

10/9/2015
164
IBM Inside Sales
IBM Wave Log Display
167

10/9/2015
165
IBM Inside Sales
BTS Work Units
168

10/9/2015
166
IBM Inside Sales
BTS System COR
169

10/9/2015
167
IBM Inside Sales
BTS Log and Attention Required
170

10/9/2015
168
IBM Inside Sales
Status Bar
171

10/9/2015
169
IBM Inside Sales
IBM Wave Command Line Interface
172
The Wave Command Line Interface (CLI) is optional and not required for
Wave and the Wave GUI to operate. But if you want be able to use it you
need to set up a method of sending the required files to the destination
server or workstation. In our environment we did set up an anonymous
FTP server in our WAVESRV server that allows access to those files.

10/9/2015
170
IBM Inside Sales
IBM Wave for z/VM
Managing z/VM

10/9/2015
171
IBM Inside Sales
Agenda
• Managing z/VM User IDs
• Live Guest Relocation
• Managing Device Pools
• Managing DASD
• Managing the Network
174

10/9/2015
172
IBM Inside Sales
Managing z/VM User IDs
• Define a z/VM User ID
• View details of the z/VM User ID
• Activate a new z/VM User ID
• Log into CMS as a new z/VM User ID
• Deactivate z/VM User ID
• Remove a z/VM User ID
175

10/9/2015
173
IBM Inside Sales
Define a z/VM User ID
176

10/9/2015
174
IBM Inside Sales
Ensure that the Group By Drop-Down Menu is set to Site Defined Group in order to display icons representing each of the Site Defined Groups as
shown below.
177

10/9/2015
175
IBM Inside Sales
178

10/9/2015
176
IBM Inside Sales
Starting the “Create New z/VM User”
task will open up a pop-up window
with a variety of fields needed to
create a new z/VM user.
179

10/9/2015
177
IBM Inside Sales
When you’ve completed the panel, click the Create button. Once all fields are accepted, a progress bar will appear on the bottom of the panel
alongside a text area that explains the z/VM tasks that IBM Wave for z/VM is automatically performing.
180

10/9/2015
178
IBM Inside Sales
Once the “Create New z/VM User” task is complete, your z/VM user will appear in the selected Site Defined Group as an inactive guest.
181

10/9/2015
179
IBM Inside Sales
View details of z/VM User ID
Double click on the icon of the new z/VM User ID to display its details. The most useful information is found in the z/VM view, which displays the
User ID’s complete directory entry, as shown below.
182

10/9/2015
180
IBM Inside Sales
View details of z/VM User ID
183

10/9/2015
181
IBM Inside Sales
Activate new z/VM User ID
184

10/9/2015
182
IBM Inside Sales
185

10/9/2015
183
IBM Inside Sales
186

10/9/2015
184
IBM Inside Sales
Log into CMS as new z/VM User ID
To enter z/VM User ID CMS environment, right-click on the icon of your new running z/VM user and select “3270” to open an integrated 3270
terminal as shown below.
187

10/9/2015
185
IBM Inside Sales
188

10/9/2015
186
IBM Inside Sales
189

10/9/2015
187
IBM Inside Sales
Deactivate z/VM User ID
190

10/9/2015
188
IBM Inside Sales
191

10/9/2015
189
IBM Inside Sales
Once you have selected “Force z/VM User Logoff” and clicked Go, you are presented with a Confirmation Pop-Up titled “Force confirmation”. Click
“OK” to proceed.
192

10/9/2015
190
IBM Inside Sales
Remove a z/VM User ID
There will be times that you will need to remove a z/VM userid. To do this, perform the following steps:
1. Right-click one or more userids.
2. Select More Actions
3. Select Delete.
193

10/9/2015
191
IBM Inside Sales
Confirm that the checkbox next to each of userids that you’d like to delete is checked.
194
Select “Erase Disk Contents” if you’d like to Erase Disk Contents.

10/9/2015
192
IBM Inside Sales
Click the Go button then You will see a confirmation screen as below.
195
Click Yes if you are sure that you would like to proceed. You will receive a message showing that your
request has been submitted to the BTS.

10/9/2015
193
IBM Inside Sales
If you would like to see the progress of the work unit, open the BTS Work Units tab, and double-click on your “Delete z/VM Guests” task as below.
196

10/9/2015
194
IBM Inside Sales
IBM Wave for z/VM
Live Guest Relocation

10/9/2015
195
IBM Inside Sales
Life Guest Relocation is a feature in z/VM 6.3 allowing you to move z/VM Linux
guests systems from one system in a SSI cluster to another while the guest is
active.
If you want to relocate one or many z/VM guests, Wave allows you to do that
using drag and drop or by selecting a command to do so.

10/9/2015
196
IBM Inside Sales
This is an example of two Linux guests being moved from one System to another
using drag and drop. Switch to the Enterprise Viewer and group by z/VM
Systems:

10/9/2015
197
IBM Inside Sales
Then you should set some filters according to the guests you want to move. In a
production environment you might be dealing with several hundreds guests. In
this example the filter reduced the Users from 39 to 9.

10/9/2015
198
IBM Inside Sales
Open the system you want to relocated the guests from:

10/9/2015
199
IBM Inside Sales
To select the guests use shift and click. Once you selected one or many guests
to relocate, hit Control on your keyboard and keep holding it, then drag the
selected guests to the system you like.

10/9/2015
200
IBM Inside Sales
The following z/VM Live Guest Relocation popup window appears:

10/9/2015
201
IBM Inside Sales
You can make changes here and then click on Go

10/9/2015
202
IBM Inside Sales
Workunit submitted to BTS and IBM Wave starts to relocate the selected guests.

10/9/2015
203
IBM Inside Sales
LGR in progress:

10/9/2015
204
IBM Inside Sales
LGR in progress:

10/9/2015
205
IBM Inside Sales
LGR complete, Wave Network detection pending:

10/9/2015
206
IBM Inside Sales
LGR complete:

10/9/2015
207
IBM Inside Sales
This is an example shows the ‘command’ version of LGR. Select the guest you
like to relocate. Right click on it --> More Actions --> Relocate to:

10/9/2015
208
IBM Inside Sales
IBM Wave for z/VM
Managing Device Pools

10/9/2015
209
IBM Inside Sales
Agenda
• Device Pool Manager
• Device Pool Use Cases
• Create new Device Pool
• Associate Device Pool to z/VM system
• Transfer Real Device from one Pool to another
• Delete Device Pool
212

10/9/2015
210
IBM Inside Sales
Manage Device Pools
213

10/9/2015
211
IBM Inside Sales
Dedicated Devices Pools Manager
214
 Dedicated devices are managed in pools using the Device Pools Manager
 Employs three device-class pools
– DASD (FCP and ECKD)
– HiperSockets™
– OSAs
 Can manage multiple pools

10/9/2015
212
IBM Inside Sales
Device pool icons
215

10/9/2015
213
IBM Inside Sales
Dedicated Devices Pools
216
 Drilling into the Device Pool Manager, we get to the actual Device Pools, which lists
information about each device in the pool

10/9/2015
214
IBM Inside Sales
OSA Dedicated Device Pool example
217

10/9/2015
215
IBM Inside Sales
Dedicated Devices Pools Use Cases
218
 Cloning
– Guests with Dedicated DASD (FCP and ECKD) devices
– Guests with Dedicated HiperSockets devices
– Guests with Dedicated OSA devices
 Defining new VSwitches
– Connected to an OSA card

10/9/2015
216
IBM Inside Sales
Dedicated Devices Pools Use Cases
219
Clone processes

10/9/2015
217
IBM Inside Sales
Dedicated Devices Pools User Cases
220
Defining new VSwitches

10/9/2015
218
IBM Inside Sales
Create new Device Pool
To do this, you first need to open Device Pools Manager by clicking on the Administrative
menu and selecting the “Manage Device Pools” from the “Site Management” submenu as
shown below.
221

10/9/2015
219
IBM Inside Sales
It then brings up a dialog called ‘Device Pool Manager.’ Click “Create New Device Pool” .
222

10/9/2015
220
IBM Inside Sales
In the “Create New Device Pool Dialog”, Enter a Device Pool Name and select the TYPE
of Device Pool, (e.g. OSA). A description is optional. You can also optionally specify a
Default Virtual Device and Click the “Create” button.
223

10/9/2015
221
IBM Inside Sales
224

10/9/2015
222
IBM Inside Sales
Associate Device Pool to z/VM system
225

10/9/2015
223
IBM Inside Sales
226

10/9/2015
224
IBM Inside Sales
In the popup window, select which z/VM system that you want to associate the device pool
with, then click the “Go” button.
227
After clicking “Go,” you will see a pop-up that states that the workunit has been dispatched to
the Background Task Scheduler (BTS). And you will see the Associated z/VM System. Notice
that there are No devices found for the selected z/VM System yet.
.

10/9/2015
225
IBM Inside Sales
Transfer Real Devices from one Pool to another
To transfer Real Devices from one OSA pool to the newly created pool, in the “Device Pool
Manager” dialog box, right click on the source pool entry and select “Update Details”
228

10/9/2015
226
IBM Inside Sales
Transfer Real Device from one Pool to anther
It will open a dialog for you to update the selected device pool. Select the “Devices” tab,
and Select the Real Devices that you want to transfer (in this cases, 2009-200B).
229

10/9/2015
227
IBM Inside Sales
230

10/9/2015
228
IBM Inside Sales
231

10/9/2015
229
IBM Inside Sales
Delete Device Pool
232

10/9/2015
230
IBM Inside Sales
Delete Device Pool
If there is a 0 in the Devices column it means that there is no real device that belongs to
this pool, and you can delete it by right-clicking, and select “Remove Device Pool” from the
“More Actions” submenu as shown below.
233

10/9/2015
231
IBM Inside Sales
Delete Device Pool
After clicking “Remove Device Pool”, You will see a confirmation screen
234
Click Yes if you are sure that you would like to proceed. You will receive a message showing
that your request has been submitted to the BTS and your Device Pool will be removed.

10/9/2015
232
IBM Inside Sales
More about Device Pools
235
 IBM Wave uses internal z/VM data to retrieve a unique ID for each Real Device.
– This unique ID is made up of the Logical Control Unit ID with other elements
– This unique ID is a unique identification for each device.
 Attention Required status
– If any real device was dedicated to z/VM guest on two or more z/VM systems, IBM Wave
would raise an Attention Required status for the real devices.
– If this situation is acceptable, the Attention Required Entry can be ignored.
 Transfer Real Devices
– Since Device Pools are associated with Real Devices by their Unique ID, all Real Devices
with same Unique ID are transferred to the target Device Pool.
 It is possible to link a Managed Entity to a Device Pool.
– It is pure meta-data.
– e.g. It is possible to link an OSA Device Pool to a Router Managed Entity. The Network
Viewer will display a link between the Device Pool and the Router.

10/9/2015
233
IBM Inside Sales
IBM Wave for z/VM
Managing DASD

10/9/2015
234
IBM Inside Sales
Agenda
• Add new DASD Group
• Attaching DASD Volumes to System
• Define Regions to DASD Volumes
• Assign Volumes to Group
• Delete DASD Group
237

10/9/2015
235
IBM Inside Sales
DASD Management in z/VM
• User Volumes must be attached to SYSTEM
• If using a directory manager such as DIRMAINT to manage DASD, work with the
EXTENT CONTROL file.
:REGIONS
Defines an area or region on your DASD volume for use during DirMaint automatic
allocation.
:GROUPS.
Defines a grouping of regions for use during DirMaint automatic allocation.
• How to manage DASD using IBM Wave then?
238

10/9/2015
236
IBM Inside Sales
Add new DASD Group
Open the Hardware Viewer and click on the Storage Tab. On the leftmost column of the Current System
View, there are three buttons entitled Distribution, Groups, and Volumes. Click on the Group Tab.
239

10/9/2015
237
IBM Inside Sales
Add new DASD Group
240

10/9/2015
238
IBM Inside Sales
Add new DASD Group
241

10/9/2015
239
IBM Inside Sales
Add new DASD Group
242

10/9/2015
240
IBM Inside Sales
Attaching DASD Volumes to System
243

10/9/2015
241
IBM Inside Sales
244

10/9/2015
242
IBM Inside Sales
Once the filter criteria is applied, the number of volumes displayed will decrease and the icons will resize
to fill the display.
245

10/9/2015
243
IBM Inside Sales
Once you have displayed the specific volumes that you would like to attach to the system, select one or
more volumes and then right-click and select “Attach to System”.
246

10/9/2015
244
IBM Inside Sales
Starting the “Attach to System” task will opens another new window. Ensure that the volumes that you
want to attach to system are checked. Click the “Go” button to start the task.
247
After clicking “Go,” you will see a pop-up that states that the workunit has been dispatched to the
Background Task Scheduler (BTS). You can then close the “Attach DASD Volumes to z/VM System” panel.

10/9/2015
245
IBM Inside Sales
Define Regions to DASD Volumes
Now that the DASD volumes have been attached to the system, you must define the volume in
DIRMAINT extent control as a whole-volume region. This is done in IBM Wave for z/VM by selecting one
or more volumes that have been attached to the system, right-clicking, and selecting the task “Define
Region.”.
248

IBM Wave for z/VM

Recommended

Recommended

More Related Content

What's hot

What's hot (15)

Viewers also liked

Viewers also liked (11)

Similar to IBM Wave for z/VM

Similar to IBM Wave for z/VM (20)

More from Anderson Bassani

More from Anderson Bassani (14)

Recently uploaded

Recently uploaded (20)

IBM Wave for z/VM