SSVSPA_2.3.3 - Documentation Index

Table of Contents

• IBM PowerVC for Private Cloud version 2.3.3 documentation
• Introduction
  • PowerVC high availability and scale architecture
  • What's new in PowerVC for Private Cloud
  • Terminology
  • Feature support of PowerVC for Private Cloud edition
  • Topology overview
  • PowerVC UI known issues and limitations
    • UI performance enhancement for periodic synchronization
• Planning for PowerVC
  • Hardware and software requirements
  • Planning for hosts
    • Planning for PowerVM hosts
      • Changing a host from HMC managed to NovaLink managed
      • Changing a host from NovaLink managed to HMC managed
    • Compute plane node and HMC host scaling
    • Host groups
    • Host standby mode
    • Reservation host
    • Virtual serial number (VSN)
  • Planning for networks
    • Planning for multiple networks
    • Planning Shared Ethernet Adapter mapping
    • SR-IOV backed networks
      • Planning SR-IOV networks
      • Using an SR-IOV backed network
    • Physical network names
    • IPv6 support for AIX Guest operating system
  • Planning for performance
    • Planning for AME
    • PowerVC scalability configuration
  • Planning for security
    • Service users and permissions
    • Ports used by PowerVC
    • Security header
    • Package signing
    • Multi-Factor authentication
  • Planning for storage
    • Planning for vSCSI
      • Before using vSCSI storage
      • Working with vSCSI: Best practices
      • Configuring zoning for vSCSI
    • Planning for storage providers
      • Planning for IBM FlashSystem and Storwize family storage
        • Global mirror feature on IBM Storwize
        • HyperSwap feature on IBM Storwize
        • FlashSystem 8.7.X NPIV Enablement
        • Policy-based High Availability feature on IBM Storwize
          • Before working with PBHA
          • Register PBHA with Storwize
          • Configure host sites
          • Volumes and Volume Group Lifecycle operations
          • VM snapshot, VM restore, and offline capture
          • Failover and failback
      • Planning for Pure Storage
        • Replication feature on Pure Storage
      • Planning for EMC PowerMax storage
      • Hitachi Block Storage driver support
        • Before managing Hitachi storage
        • Planning for Hitachi Global-active device (GAD)
      • Planning for HPE storage
      • Planning for IBM System Storage DS8000
      • Planning for shared storage pools
    • Register Fibre Channel tape drives
    • Fibre Channel switch zoning
    • Fibre channel port assignments
    • Working with Brocade virtual fabrics
    • Functions available on pluggable and integrated storage drivers
  • Planning for web proxy compatibility
  • Sample configurations
    • Single host configuration - NovaLink managed hosts
    • Single host configuration
    • SAN storage configuration
• Setting up the environment
  • Configure sudo user
  • Configuring the storage controller and SAN switch
  • Creating shared storage pools
  • Set up an RMC connection
  • Configuring hosts
    • Configuring PowerVM hosts managed by HMC
      • Installing the Virtual I/O Server
      • Accepting the Virtual I/O Server license agreement
      • Entering the PowerVM Editions activation code
      • Configuring a Shared Ethernet Adapter
      • Changing the maximum number of virtual resources
      • Changing the logical memory block capacity
    • Configuring PowerVM hosts managed by NovaLink
    • Preparing the management server or host
      • Creating the management virtual machine
      • Installing RHEL on the PowerVC management server or host
      • Installing SUSE Linux on the management server or host
• Installing and uninstalling
  • Installing from download
  • Installing from media
  • Initiate installation through PowerVC operations manager
    • Create VIP and node IP from different subnet
    • Add or replace nodes
  • Uninstalling
• Upgrading to PowerVC for Private Cloud 2.3.3
• PowerVC offline upgrade
• PowerVC rolling upgrade
• Backing up
  • Recovering IBM Power Virtualization Center data
• Getting fixes from Fix Central
• Getting started as an administrator
  • Verifying your environment
  • Monitoring resource health
  • Limitations when managing resources outside of PowerVC
• Managing PowerVC as an administrator
  • Configuring PowerVC
    • Configuring email
    • Email preferences
    • Placement policies
    • Configure non-hscroot user for HMC registration
    • Configuring security
      • Authentication
        • Configuring operating system users and groups
        • Configuring LDAP
        • PowerVC UI login
        • Simultaneous login alert message
        • PowerVC UI session inactivity timeout and reauthentication
        • Configure Multi-Factor authentication for a user
      • Managing roles
      • Managing projects
        • Setting project policies
        • Setting project quotas
      • Replacing the certificate for PowerVC access
      • Replacing messaging certificates
      • Renewing PowerVC certificates
      • Enabling SELinux enforcing mode after PowerVC is installed
    • Adding resources to PowerVC
      • Managing existing volumes
        • Working with shared volumes
      • Managing existing virtual machines
        • Requirements for managing existing virtual machines
      • Managing pluggable storage or fabrics
      • Creating a network and mapping it to an SEA
    • Customizing PowerVC
      • Collocation rules
      • Compute templates
      • Deploy templates
      • Storage templates
        • Configuring storage port groups
        • Configuring initiator port groups
      • Storage connectivity groups
      • Configuring Fibre Channel ports
    • Customizing RabbitMQ messaging
    • Dynamic Resource Optimizer
      • DRO with Dynamic Capacity on Demand
        • CoD requirements and considerations
      • Enabling DRO and reviewing DRO events
      • DRO migrations
  • Working with images
    • Creating deploy templates
    • Creating an image from ISO
    • PowerVC image OVA package details
    • Creating an image from existing volumes
    • Deploying a virtual machine using existing boot and data volumes
    • Exporting and importing images
      • Export and import images using CLI
      • Export and import images using GUI
      • Manually importing and exporting volumes
      • Registering a backup node
      • Registering IBM Cloud Object Storage in PowerVC
    • Capturing a virtual machine
      • Capture requirements
      • Installing and configuring cloud-init
        • Installing and configuring cloud-init on Linux
          • Installing and configuring cloud-init on SLES
          • Installing and configuring cloud-init on RHEL
          • Installing and configuring cloud-init on Ubuntu
          • PowerVC cloud-init modules
        • Installing cloud-init on AIX
          • Custom PowerVC cloud-init modules
        • Installing and configuring cloud-init on IBM i
      • Uninstalling the activation engine
    • Deploying captured images
      • Deploying a virtual machine from a template
      • Deploy requirements for captured images
      • Injecting an SSH key
      • Considerations for deploying captured or imported images
      • Setting a default domain name for deployed virtual machines
      • Multiple shared processor pools
  • Managing requests
  • Working with virtual machines
    • Deploy virtual machines without volumes in PowerVC GUI
    • Pin virtual machine to a host
    • Recall virtual machines to a host
    • Virtual machine snapshot or restore
    • Clone virtual machines
    • Dump restart a virtual machine
    • Persistent memory virtualization for virtual machine
    • Migrating a virtual machine
      • Migration requirements
    • Reset task state of a virtual machine
    • Remote restart
      • Automated remote restart
      • Remote restart with standby host
      • Remote restart virtual machines from a failed host
        • Remote restart considerations
        • Remote restart virtual machines
        • Remote restart outside of PowerVC
        • Remote restart requirements
    • Changing the owner of a virtual machine
    • NovaLink managed virtual machine console enhancements in PowerVC
    • Deploy a virtual machine with a minimum affinity score
  • Scenario: Create a project with deploy templates
  • Working with volumes
    • Clone volumes
    • Consistency groups
    • Retype
    • Transient volume recovery
  • Maintaining hosts
    • Updating a host's IP address
    • Moving a host to maintenance mode
  • Viewing usage information (metering data)
• Installing the IBM PowerVC Container Storage Interface driver on OpenShift Container Platform
• PowerVC Squall service
• Managing PowerVC as a user
  • Working with virtual machines
    • Creating virtual machines
  • Managing my requests
  • Viewing my usage information (metering data)
• Troubleshooting and support
  • Techniques for troubleshooting problems
    • Messages
    • Deploy, resize, and live migration error codes
    • Exporting audit data
    • Installation failed with error DBI1288E
    • Troubleshooting UI login issues related to CORS configuration
  • Searching knowledge bases
  • Collecting data for PowerVC problems
    • powervc-diag command
    • PowerVC Log management
  • Contacting IBM Support
  • Sending information to IBM Support
  • Subscribing to Support updates
  • Known problems and solutions
    • Authentication fails when connecting to the HMC
    • Access denied error when uploading an image to COS
    • Cannot connect to a virtual machine over SSH
    • Changing processor mode for a virtual machine
    • Compute host registration fails with error PD-A000314
    • Compute host that is powered off and unregistered from PowerVC displays back in PowerVC after power on
    • CPU soft lockup messages on console or dmesg output: IBM PowerVC for Private Cloud version 2.3.3
    • The curl command returns an error
    • Compute template could not be created with certain Unicode characters
    • Deletion of volume attached to a virtual machine fails with error after live capture
    • Delete or detach volume fails in SVC
    • Deploying a virtual machine on an SR-IOV enabled NovaLink host fails: IBM PowerVC for Private Cloud version 2.3.3
    • Deploying multiple virtual machines on DS8000 fails with error message: IBM PowerVC for Private Cloud version 2.3.3
    • Planning for IBM FlashSystem and Storwize family storage
    • Deployment of images fails
    • Deployment fails when using IBM Storwize cinder driver with reduction pool storage array
    • Deploy or attach of a vSCSI attached virtual machine fails
    • Delete virtual machine fails
    • The EGO service will not start due to long domain name
    • Environment verification tool fails or you cannot log on to PowerVC
    • Error when uploading or downloading images from IBM Cloud Object Storage
    • Error when running powervc-validate --start command
    • Failed uninstall of PowerVC
    • Health status is not OK
    • Health status changes to 'Attention' when password of host is changed
    • HMC is in Attention state after upgrading it to the latest version
    • Home page does not load
    • Invalid argument client error when doing COS operations
    • MAC address conflict
    • Memory utilization of a virtual machine shows full utilization when RMC is inactive
    • Migrating a virtual machine from a P6 host fails
    • Newly added network interface is not configured at OS level
    • Newly deployed virtual machine status shows "Warning"
    • Network node is in Attention state
    • NovaLink host remains in Unknown state when PowerVC management server is restarted
    • Operations on a deployed virtual machine fail
    • powervc-diag command is hung
    • PowerVC installation fails on RHEL 8.2 or RHEL 8.3
    • PowerVC installation fails due to IPv6
    • PowerVC server connection was lost
    • PowerVC volume image import failed
    • The NovaLink virtual machine console login displays incorrectly
    • Recovering an incomplete migration
    • Resizing a virtual machine fails
    • Resource registration fails when using hostname
    • Restarting services after a power outage
    • Restarting services after HMC is restarted
    • RMC communication to VIOS is busy or timed out
    • RMC inactive for RHEL 8 guest OS on NovaLink hosts
    • Restarting services before a task is complete
    • Safeguarded Snapshots usage in PowerVC is not supported
    • SEA is not selected in the Network details page after VIOS or firmware upgrade for an HMC managed host
    • SEA is not selected when NovaLink host is re-added
    • SR-IOV Deploy is Failing due to Invalid VLAN ID
    • Some sessions remain idle in HMC due to K2 REST API calls from PowerVC
    • SMI-S provider connectivity issues
    • Tasks remain in the Initializing state
    • Tasks remain in the Scheduling state
    • Troubleshooting a Spectrum Scale cloud
    • Unable to login to PowerVC GUI
    • A valid host was not found
    • A virtual machine gets stuck in migrating status
    • Virtual machines get stuck in a warning state with a Cisco switch
    • Virtual machine health shows OK even if a boot volume is deleted outside PowerVC
    • VM task state remains stuck
    • VM console limitations
• CLI commands
  • Setting environment variables
  • Database maintenance
  • Rename a cluster
  • Update the Compute plane node IP and optionally update the hostname
  • Update the node IP address and optionally update the hostname
  • Update VIP settings by using OpsMgr
  • powervc-dbcheck Utility
• Publications and related information
• Accessibility features in IBM PowerVC for Private Cloud
• PowerVC virtual appliance
  • Introduction of PowerVC virtual appliance
  • Hardware and software requirements for PVCVA
  • PowerVC appliance offline upgrade
  • PowerVC appliance rolling upgrade
    • Preparing for upgrade
    • Upgrading PowerVC on multinode
    • Post-upgrade considerations
  • PowerVC virtual appliance (PVCVA) deployment
    • PVCVA boot up methods
      • Boot virtual machine by using BOOTP server
      • Boot virtual machine by using vOPT
      • Boot virtual machine by using vOPT and Cloud-init ISO
    • Create inventory and configure the virtual machine
  • User management
  • Restricted shell
    • CLI commands
      • awk Command
      • cat Command
      • chpvc Command
      • chpvcfs Command
      • chpvcuser Command
      • createrc Command
      • cut Command
      • date Command
      • df Command
      • diff Command
      • du Command
      • echo Command
      • egrep Command
      • expr Command
      • fgrep Command
      • file Command
      • getopt Command
      • grep Command
      • gunzip Command
      • head Command
      • host Command
      • hostname Command
      • ifconfig Command
      • ip Command
      • kill Command
      • locale Command
      • ls Command
      • lsblk Command
      • lslocks Command
      • lspvc Command
      • lspvcfs Command
      • md5sum Command
      • mkauthkeys Command
      • mkpvcuser Command
      • more Command
      • nmcli Command
      • nslookup Command
      • pesh Command
      • ping Command
      • powervc-check-lku-bdm Command
      • powervc-configmod Command
      • powervc-dbop Command
      • powervcrpm Command
      • powervc-opsmgr backup and restore command
      • powervc-opsmgr inventory Command
      • powervc-opsmgr configure Command
      • ps Command
      • pvc-vm-topo Command
      • pvcexpand Command
      • pvcmount Command
      • pvcstop Command
      • pvcscheduler Command
      • reboot Command
      • rm Command
      • rmdir Command
      • rmpvcuser Command
      • scp Command
      • sha256sum Command
      • shutdown Command
      • sleep Command
      • socat Command
      • sort Command
      • ssh Command
      • sum Command
      • tail Command
      • tar Command
      • uname Command
      • watch Command
      • which Command
      • who Command
      • whoami Command
    • Monitor
      • pvcmonitor Command
      • pvcmon Command
  • PowerVC virtual appliance (PVCVA) backup
  • Recovering IBM Power Virtualization Center data
  • Migrate to PowerVC appliance environment
  • Export and import images by using CLI in PVCVA
  • PowerVC appliance interim fix
  • PowerVC Log management
• Notices
• REST APIs
  • Getting started with APIs
    • Authenticating with PowerVC
    • Create network and subnet
    • Register a storage host
    • Register a compute host
    • Register images
    • Deploy servers
  • Northbound REST APIs
  • PowerVC services
  • Identity (Keystone) APIs
    • Supported OpenStack Identity (Keystone) APIs
  • Compute (Nova) APIs
    • Supported OpenStack Compute (Nova) APIs
    • Bulk attach and detach volume APIs
    • Volume instance mapping API
    • Virtual machine snapshot and restore API
    • Compute host registration
    • Compute plane node
    • Configure SR-IOV adapters
    • Injecting license keys for IBM virtual machines
    • Clone virtual machine API
    • Persistent memory virtualization API
    • DRO events APIs
    • Deploy VMs without volumes
    • Update volume attachment
    • Nova placement policy
    • Host network mapping
    • Host network placement
    • Host Shared Ethernet Adapters
    • HMC registration
    • Host maintenance mode
    • Host standby mode API
    • Remote restart all virtual machines from a failed host (APIs)
    • Support for processing units
    • Automatic flavors
    • Flavors extra-specs
    • Base storage connectivity group APIs
    • Additional storage connectivity group APIs and extensions
    • Manage existing virtual machines
    • Virtual serial number (VSN) APIs
  • Reservation (Blazar) APIs
    • Reservation host APIs
  • Block storage (cinder) APIs
    • Supported OpenStack block storage (Cinder) APIs
    • Additional metrics
    • Backup node registration
    • Bulk volume create API
    • Get bulk volume API
    • Bulk volume delete API
    • Clone volume API
    • Snapshot capacity usage API
    • Export or import image
    • Extend volume capacity
    • Manage Existing Volumes
    • The recover_volumes and get_progress APIs
    • Registering IBM Cloud Object Storage
    • Retype validation APIs
    • SAN fabric registration
    • Storage controller registration
    • Supported volume type extra-specs
    • Working with snapshots and consistency groups
  • Images (glance) APIs
    • Supported OpenStack Glance (images) APIs
    • Create image API
  • Networks (Neutron) APIs
    • Supported OpenStack Networks (Neutron) APIs
  • Supported OpenStack Telemetry APIs
    • Supported Gnocchi APIs
    • Supported metrics
    • Supported OpenStack Event (Panko) APIs
  • Other APIs
    • PowerVC version
    • Scheduled tasks
    • Validate environment
    • Virtual machine ref_code API
    • Virtual machine arr_enabled API