Readme for IBM PowerVM NovaLink 1.0.0.5 This is the March 2017 release of IBM PowerVM NovaLink. Learn more about PowerVM NovaLink at * https://ibm.biz/pvm224-novalink (Blog) * https://ibm.biz/novalink-kc (Knowledge Center) Download of the IBM PowerVM NovaLink installation media is available at the Entitled Systems Support site (ESS). http://www-304.ibm.com/servers/eserver/ess/OpenServlet.wss NovaLinkis entitled for download if you have a license for IBM PowerVM * IBM PowerVM Virtual I/O Server Enterprise Version 2.2.4 5765-PVE * IBM PowerVM Virtual I/O Server Standard Version 2.2.4 5765-PVS * IBM PowerVM for IBM PowerLinux Virtual I/O Server Version 2.2.4 5765-PVL Table of Contents How to update. 1 <#_Toc469321029> Changes in 1.0.0.5. 2 <#_Toc469321030> Known Issues. 2 <#_Toc469321031> Installation. 5 <#_Toc469321032> Upgrading from Ubuntu 15.10 to 16.04.2 LTS.. 5 <#_Toc469321033> Software Life Cycle. 7 <#_Toc469321034> How to update Fixes and service packs for this product are available in the following online repositories: · Ubuntu: https://public.dhe.ibm.com/systems/virtualization/Novalink/debian · RHEL 7.3: https://public.dhe.ibm.com/systems/virtualization/Novalink/rhel/73/novalink_1.0.0 To upgrade to the 1.0.0.5 release, run the following: · If you are currently running Ubuntu 15.10, you will need to upgrade to Ubuntu 16.04.2 LTS as 15.10 is no longer supported by Canonical. You should do this before you update NovaLink. · Update the apt repository cache o *sudo**apt update* · Upgrade to 1.0.0.5. The ‘upgrade’ will upgrade all software, or you can specifically only update the NovaLink and RSCT portion.** o *sudo**apt upgrade *(or alternatively: *sudo**apt install pvm-novalink rsct.basic*)** · Remove old packages that are no longer used (optional)** o *sudo**apt-get autoremove* See the Knowledge Center documentation for more information on installing fixes and updates · http://www.ibm.com/support/knowledgecenter/POWER8/p8eig/p8eig_updating_ubuntu_online.htm?cp=POWER8 Changes in 1.0.0.5 · Support for Ubuntu 16.04.2 LTS · Advanced GRUB menu option for SDN installation · Installer post install script support · Bug fixes Changes Details · Advanced GRUB menu option for SDN installation o User can enable NovaLink SDN installation mode in the advanced GRUB menu · Installer post install script support o User can specify customized post NovaLink install commands/scripts to run by using the “PostInstallCommand” variable under the [NovaLinkConfiguration] section in the template. Known Issues · Issues affecting HMC Co-Management o Prior to converting a system to a co-managed environment, the user should create a backup of the profile data (bkprofdata) on the HMC. This will allow the user to revert back to the state prior to co-management should they desire. o Any LPAR that has not been powered on at least once prior to switching over to a co-managed mode will need to be re-created. o The HMC Enhanced UI should be used when using the HMC in a co-managed mode. The classic UI is missing key functionality due to the lack of partition profiles when running co-managed. o NovaLinkdoes not currently have support for Active Memory Sharing or Hibernation. · Issues affecting full installs (where NovaLink deploys the entire PowerVM stack including the VIOS). o When performing a full install on a new system, if any error occurs before the VIOS server(s) have been created or installed, you will need to reset the system in order to try again. *Resolution:* If you encounter an error during the creation or installation of the VIOS Server(s), you will need to reset your system to the initial factory settings. This can be done via the ASMI interface or by rebooting the NovaLink partition and use the 'Reset System' under the 'Choose to repair a system' option of the NovaLink installation wizard.** o When performing a full install on a new system, the IP addresses associated with NovaLink and the VIOS should not use the 192.168.128.1 network (or any superset). NovaLink sets up a 192.68.128.1 network through which to install the VIOS, and allocating that same network for the external facing IPs will cause the install to fail. · Issues affecting installation in an HMC environment. o NovaLinksupports using multipath I/O of physical volumes via redundant VIOSs. However, when using Virtual Optical DVD (vtoptX) to perform an installation of the NovaLink software, the same vhostY hosting the NovaLink LPARs disk must be used if the disk has multiple paths. The following is an example lsmap (on VIOS) output showing vhost0 serving both vtopt0 and vtscsi0 for hdisk1. $ lsmap -all SVSA Physloc Client Partition ID --------------- -------------------------------------------- ------------------ vhost0 U9119.MHE.21BB977-V1-C5 0x00000003 VTD vtopt0 Status Available LUN 0x8200000000000000 Backing device /var/vio/VMLibrary/novalink-installer-96-ISO Physloc Mirrored N/A VTD vtscsi0 Status Available LUN 0x8100000000000000 Backing device hdisk1 PhyslocU78CD.001.FZH8538-P1-C4-T1-W5005076802161E9F-L1000000000000 Mirrored false Installation Installation instructions for PowerVM NovaLink are available on the on-line Knowledge Center. · http://www.ibm.com/support/knowledgecenter/POWER8/p8eig/p8eig_installing.htm?cp=POWER8 Upgrading from Ubuntu 15.10 to 16.04.2 LTS NovaLink1.0.0.5 has full support for Ubuntu 16.04.2, and will install 16.04.2 by default. If you have an existing NovaLink installation based on Ubuntu 15.10 (1.0.0.2 or earlier based NovaLink), you should plan on upgrading to Ubuntu 16.04.2 LTS as the 15.10 release is out of support (see http://www.ubuntu.com/info/release-end-of-life). The following is a one-time upgrade procedure and follows the standard Ubuntu release upgrade procedure. The network device names do change, so follow this procedure to maintain network connectivity. * Only do this if you are running Ubuntu 15.10. Verify your current release with: o lsb_release–a * Make sure you have upgraded PowerVC to 1.3.1 or later first. PowerVC 1.3.0.2 will not work when managing a NovaLink running on Ubuntu 16.04.2. * Backup your system o Copy off /var/backups/pvm/ * Clean up your /etc/apt/sources.list file – remove any non-valid repositories. It only needs to contain the following (uncommented) lines: o deb http://archive.canonical.com/ubuntu wily partner deb http://ports.ubuntu.com/ubuntu-ports/ wily main restricted deb http://ports.ubuntu.com/ubuntu-ports/ wily universe deb http://ports.ubuntu.com/ubuntu-ports/ wily-security main restricted deb http://ports.ubuntu.com/ubuntu-ports/ wily-security universe deb http://ports.ubuntu.com/ubuntu-ports/ wily-updates main restricted deb http://ports.ubuntu.com/ubuntu-ports/ wily-updates universe o *NOTE: *If you are using an internal mirror of the Ubuntu repository, make sure your sources.list reflects the mirror location * Run */sudo/**/apt update/*. This will update the package list. * Run *sudo**apt install apt*. This will make sure you have the latest version of /apt/ which is needed for the release upgrade * Before you upgrade, you need to update the names off your network devices to avoid loss of network connectivity after the system reboots. o Check to see if you have this file on the system: *//etc/udev/rules.d/70-persistent-ibmveth-net.rules/* o If you do, move it to your home directory's folder. You can delete this backup once things are complete: + */sudo/**/mv /etc/udev/rules.d/70-persistent-ibmveth-net.rules ~//* o Check to see if the device driver for these network interfaces is ibmveth by running lshw: + */lshw/**/-c network/* *-network:0 description: Ethernet interface physical id: 1 logical name: eth0 serial: 1a:3a:1a:0f:c9:10 size: 1Gbit/s capacity: 1Gbit/s capabilities: ethernet physical fibre 1000bt-fd autonegotiation configuration: autonegotiation=on broadcast=yes driver=*ibmveth* driverversion=1.05 duplex=full ip=X.XX.XXX.X link=yes multicast=yes port=fibre speed=1Gbit/s *-network:1 description: Ethernet interface physical id: 2 logical name: eth1 serial: 7e:e2:03:12:79:0d size: 1Gbit/s capacity: 1Gbit/s capabilities: ethernet physical fibre 1000bt-fd autonegotiation configuration: autonegotiation=on broadcast=yes driver=*ibmveth* driverversion=1.05 duplex=full ip=X.XX.XXX.X link=yes multicast=yes port=fibre speed=1Gbit/s · If the network interfaces use ibmveth, you must edit and change their name in the*/ /etc/network/interfaces/* file. Beginning with 16.04.1, the IBM virtual ethernet device's name will be renamed to ibmveth and use the location with the name to uniquely identify it. · To determine the name to use run lscfg command and find the location associated with each interface: o *sudo**lscfg | grep eth* + eth0 U8247.22L.212A90A-V1-C*3*-T1 + eth1 U8247.22L.212A90A-V1-C*6*-T1 In this example, eth0 is at slot 3 (C3), while eth1 is at slot 6 (C6). o Make a backup of your network interfaces file: § *sudo**cp /etc/network/interfaces ~/network-interfaces.bak* o Edit the *//etc/network/interfaces /*file using sudo and replace all occurrences of eth0 with ibmvethX, then all occurrences of eth1 with ibmvethY, where X and Y match the slot numbers found above. In our case, eth0 -> ibmveth3 and eth1 -> ibmveth6 * Run */sudo/**/do-release-upgrade/* o Follow the prompts and enter 'y' to all the questions. It’s recommended to accept the package maintainers version if asked unless you’ve installed custom software (other than NovaLink). The system will eventually reboot. * When the system comes back up, you will need to re-enable the following repositories: o NovaLinkrepository § */sudo/**/cp /etc/apt/sources.list.d/pvm.list.distUpgrade /etc/apt/sources.list.d/pvm.list/* o RSCT repository (if enabled)** § *sudo**apt install software-properties-common* § *sudo**rm -f /etc/apt/sources.list.d/ibmpackages-ubuntu-rsct-wily.list** § *sudo**add-apt-repository -y ppa:ibmpackages/rsct* * Check to make sure you have all the latest software o *sudo**apt update* o *sudo**apt upgrade* * You have now completed the upgrade process for Ubuntu 16.04.2. If you haven’t already, you should update NovaLink. Software Life Cycle PowerVMNovaLink uses versioning in the form of Version, Release, Mod Level and Fix (VRMF). Example 1.0.0.5 · Version and Release increments have a 3 year software support Lifecycle and follow IBM’s standard software lifecycle (_http://www-01.ibm.com/software/support/lifecycle/lc-policy.html)_. · Mod Level (third digit) increments have an N-1 support policy. The current available Mod Level and the previous release of a Mod Level are supported. o For example if 1.0.1.x is currently the latest shipped release, then 1.0.0.x versions are in support. Once 1.0.2.x release is available, support for 1.0.0.x ceases. · Fix (fourth digit) increments indicate fix and service pack levels for the Mod Level of the release. PowerVM NovaLink uses the Debian method of delivering fixes via a fix repository. See the Knowledge Center for more information. Errata for service fixes will be posted to Fix Central .