How to upgrade InfoScale software and Solaris to 11.4 with Solaris zones using Alternate Boot Environments (ABE)
Article ID: 100047947
Updated On:
Description
Description
This article describes the steps involved with upgrading the InfoScale product suite software from 7.x to InfoScale 7.4.1.x with Solaris 11.3 running Solaris zones. In addition, the recommended steps surrounding how to best upgrade Solaris 11.3 to 11.4 are also provided.
NOTE: Solaris 11.3.x is not supported with InfoScale 7.4.2.
Prior to starting any InfoScale upgrade, the DMP tunable dmp_native_support must be disabled. This does require a reboot of the system(s).
Solaris Boot Environments
Veritas strongly encourages customers to use the Solaris beadm utility to create and manage Alternate Boot Environments (ABEs).
A system can have only one active boot environment, which is the booted environment.
Alternate boot environments (BE) can be created to manage updates made to a system. ABEs are inactive environments that are not currently booted. A system can have many inactive boot environments (ABEs).
You can activate an ABE at any time. This requires the user to activate the ABE and reboot the system to boot from that specific ABE environment, this then becomes the active BE once booted.
InfoScale 7.x to 7.4.1.x Upgrade Steps
Perform Steps 1-4 across all nodes in the cluster prior to upgrading to InfoScale 7.4.1, plus hot-fixes.
1.] Ensure all ZFS zpools are exported (deported)
# zpool list NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT rpool 69.5G 58.2G 11.3G 83% 1.00x ONLINE -
2.] DMP tunable dmp native support must be turned off :
# vxdmpadm gettune dmp_native_support Tunable Current Value Default Value ------------------------------ ------------- ------------- dmp_native_support off off
If not shown as off, disable dmp_native_support by running:
# vxdmpadm settune dmp_native_support=off
NOTE: The system will require a reboot in order to disable it.
3.] Solaris zones must be shown as configured or running. Zones listed in an unavailable state can be commented out the /etc/zones/index file.
# zoneadm list -cv ID NAME STATUS PATH BRAND IP
0 global running / solaris shared
1 newzone1 running /rpool/newzone1 solaris excl
2 newzone2 running /rpool/newzone2 solaris shared
4.] Create ABE
NOTE: Only create the ABE prior to starting the CPI installer, in case changes are required to correct zones and other operating system attributes.
# beadm create BE1
# mkdir /BE
# beadm mount BE1 /BE
# beadm listBE Name Flags Mountpoint Space Policy Created
------------------ ----- ---------- ------- ------ ----------------
BE1 - /BE 10.25G static 2020-06-25 10:33
solaris-1 - - 2.65G static 2020-06-03 05:16
solaris-1-backup-1 NR / 221.11M static 2020-06-05 08:51
5.] Contact Veritas Technical Support to obtain the following 2 patches:
a.] 7.4.1.private hot-fix bundle (infoscale-sol11_sparc-Patch-7.4.1.2201.tar.gz)
b.] CPI installer patch (patch_741.pl)
Once downloaded, create a temporary directory called /var/tmp/vcs.
Copy the downloaded patches to /var/tmp/vcs, then extract the infoscale-sol11_sparc-Patch-7.4.1.2201.tar.gz tarball under the /var/tmp/vcs directory.
# pwd/var/tmp/vcs
# lsinfoscale-sol11_sparc-Patch-7.4.1.2201.tar patch_741.pl README
installVRTSinfoscale741P2201 patches scripts
The Common Platform Installer (CPI) patch is named patch_741.pl
The /var/tmp/vcs/patches directory contains the 3 InfoScale related patches for 7.4.1.
# ls -ll patchestotal 177543
-rw-r--r-- 1 root root 7875 Jun 23 21:21 README
-rw-r--r-- 1 root root 2088 Jun 24 02:19 README_VTAS.VRTSodm
-rw-r--r-- 1 root root 8175 Jun 24 02:19 README_VTAS.VRTSvxvm
-rwxr-xr-x 1 root root 2439 May 14 07:25 REDME_VTAS.VRTSvxfs
-rwxr-xr-x 1 root root 634880 Jun 23 19:34 VRTSodm.p5p
-rwxr-xr-x 1 root root 18391040 May 14 10:26 VRTSvxfs.p5p
-rwxr-xr-x 1 root root 71516160 Jun 23 19:35 VRTSvxvm.p5p
.
c.] Download the InfoScale 7.4.1 Veritas software to /var/tmp/
# pwd/var/tmp/dvd1-sol_sparc/sol11_sparc
# lscopyright docs EULA installer perl pkgs scripts tools windows
Now run the installer using the following arguments from the /var/tmp/dvd1-sol_sparc/sol11_sparc directory:
# /installer -rootpath /BE -require /var/tmp/vcs/patch_741.pl -patch_path /var/tmp/vcs
NOTES:
The -rootpath option is used to specify the mount-point for an Alternate Boot Environment (ABE) which is currently mounted
The -require option is used to specify the location of a CPI installer patch
The -patch_path is used to specify the location of any InfoScale patches.
In this instance, the private hot-fixes have been made compatible with the CPI installer.
6.] Once the 7.4.1 upgrade is complete, unmount activate the ABE environment created
# beadm listBE Name Flags Mountpoint Space Policy Created
------------------ ----- ---------- ------- ------ ----------------
BE1 - /BE 10.25G static 2020-06-25 10:33
solaris-1 - - 2.65G static 2020-06-03 05:16
solaris-1-backup-1 NR / 221.11M static 2020-06-05 08:51
# beadm unmount [-f] BE 1
# beadm activate BE1
# beadm listBE Name Flags Mountpoint Space Policy Created
------------------ ----- ---------- ------- ------ ----------------
BE1 R - 10.25G static 2020-06-25 10:33
solaris-1 - - 2.65G static 2020-06-03 05:16
solaris-1-backup-1 N / 221.11M static 2020-06-05 08:51
The beadm flags are as follows:
FLAG DESCRIPTION
R Active on Reboot
N Active Now
NR Active Now and Active on Reboot
- Inactive
! Unbootable BE
Now restart the system to boot from the newly activated Alternate Boot Environment (ABE).
# reboot
7.] Once the system has restarted, confirm the new BE environment is shown as "BE1":
# beadm listBE Name Flags Mountpoint Space Policy Created
------------------ ----- ---------- ------- ------ ----------------
BE1 NR / 10.25G static 2020-06-25 10:33
solaris-1 - - 2.65G static 2020-06-03 05:16
solaris-1-backup-1 - - 221.11M static 2020-06-05 08:51
8.] Check the following system changes
The VxFS and VxVM modules shown in bold below, should now reflect 7.4.1.2201:
# modinfo | grep -i vx 51 122b6bb8 61648 336 1 vxdmp (VxVM 7.4.1.2201 Multipathing Dr) 249 7bd4a000 7c58 306 1 vxlan (VXLAN tunneling driver) 253 7bf9c000 215f0 334 1 vxcafs (vxcafs 7.4.1.2201 Solaris OS 5.) 254 7ac00000 3d6370 28 1 vxfs (VxFS 7.4.1.2201 Solaris OS 5.11) 255 7be38000 61fb8 335 1 vxfen (VRTS Fence 7.4.1) 256 7be98000 2cb90 337 1 vxglm (VxGLM 7.4.1.0 SunOS 5.11) 257 7afcc000 2aa0 338 1 vxportal (VxFS 7.4.1.2201 Solaris OS 5.11) 258 7b400000 350628 339 1 vxio (VxVM 7.4.1.2201 I/O driver) 259 7bc72d70 11e8 340 1 vxspec (VxVM 7.4.1.2201 control/status ) 261 7b6fa108 20d8 342 1 vxlo (Veritas Loopback Driver 0.1) 263 1128b090 4680 344 1 vxgms (VxGMS 7.4.1.0 Solaris) 273 7afd0000 18d68 331 1 fdd (VxQIO 7.4.1.2201 Solaris OS 5.1)
The DMP tunable dmp_import_exported_zpools is now set to off by default with the installed 7.4.1.2202 VxVM hot-fix. to prevent ZFS parallel imports when enabling DMP native support
# vxdmpadm gettune dmp_import_exported_zpools Tunable Current Value Default Value ------------------------------ ------------- ------------- dmp_import_exported_zpools off off
# zpool list NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT rpool 69.5G 58.2G 11.3G 83% 1.00x ONLINE -
# vxdmpadm gettune dmp_native_support Tunable Current Value Default Value ------------------------------ ------------- ------------- dmp_native_support on off
9.] Confirm you can connect to the Solaris zones
# zoneadm list -cv ID NAME STATUS PATH BRAND IP 0 global running / solaris shared 1 newzone1 running /rpool/newzone1 solaris excl 2 newzone2 running /rpool/newzone2 solaris shared
# zlogin -C
root@newzone1:~# modinfo | grep -i vx 51 -- 61648 336 1 vxdmp (VxVM 7.4.1.2201 Multipathing Dr) 249 -- 7c58 306 1 vxlan (VXLAN tunneling driver) 253 -- 215f0 334 1 vxcafs (vxcafs 7.4.1.2201 Solaris OS 5.) 254 -- 3d6370 28 1 vxfs (VxFS 7.4.1.2201 Solaris OS 5.11) 255 -- 61fb8 335 1 vxfen (VRTS Fence 7.4.1) 256 -- 2cb90 337 1 vxglm (VxGLM 7.4.1.0 SunOS 5.11) 257 -- 2aa0 338 1 vxportal (VxFS 7.4.1.2201 Solaris OS 5.11) 258 -- 350628 339 1 vxio (VxVM 7.4.1.2201 I/O driver) 259 -- 11e8 340 1 vxspec (VxVM 7.4.1.2201 control/status ) 261 -- 20d8 342 1 vxlo (Veritas Loopback Driver 0.1) 263 -- 4680 344 1 vxgms (VxGMS 7.4.1.0 Solaris) 273 -- 18d68 331 1 fdd (VxQIO 7.4.1.2201 Solaris OS 5.1)
root@newzone1:~# pkg info | grep -i VRTS
Name: VRTSodm FMRI: pkg://Veritas/VRTSodm@7.2.0.0:20161017T091658Z Name: VRTSperl FMRI: pkg://Veritas/VRTSperl@5.26.1.0:20180822T094632Z Name: VRTSvlic FMRI: pkg://Veritas/VRTSvlic@4.1.74.2:20190111T070644Z Name: VRTSvxfs FMRI: pkg://Veritas/VRTSvxfs@7.2.0.0:20161017T075906Z
If all the zones are running as expected and have the expected Veritas product updates, proceed with the Solaris 11.4 update.
Solaris 11.4 Upgrade Steps
1.] Create new ABE on all nodes in the Veritas Cluster as shown below:
# beadm create BE2
# beadm activate BE2
# reboot
Once booted from the new ABE environment across each node in the Veritas Cluster, proceed with the Solaris 11.4 update across all nodes.
# pkg update --accept entire@11.4-11.4.22.0.1.69.4
Once complete, reboot all required Clustered nodes and confirm the Solaris patch has been successfully applied to all nodes
# cat /etc/release Oracle Solaris 11.4 SPARC Copyright (c) 1983, 2020, Oracle and/or its affiliates. Assembled 03 June 2020
# pkg info entire Name: entire Summary: entire incorporation including Support Repository Update (Oracle Solaris 11.4.22.69.4). Description: This package constrains system package versions to the same build. WARNING: Proper system update and correct package selection depend on the presence of this incorporation. Removing this package will result in an unsupported system. For more information see: https://support.oracle.com/rs?type=doc&id=2433412.1 Category: Meta Packages/Incorporations State: Installed Publisher: solaris Version: 11.4 (Oracle Solaris 11.4.22.69.4) Branch: 11.4.22.0.1.69.4 Packaging Date: June 4, 2020 at 5:11:04 PM Last Install Time: June 26, 2020 at 2:02:36 PM Size: 2.52 kB FMRI: pkg://solaris/entire@11.4-11.4.22.0.1.69.4:20200604T171104Z
Once happy, proceed to enable dmp_native_support, one node at a time.
# vxdmpadm settune dmp_native_support=on
# vxdmpadm gettune dmp_native_support Tunable Current Value Default Value ------------------------------ ------------- ------------- dmp_native_support on off
Rebooted the respective clustered nodes to enable dmp_native_support and manage the ZFS devices using Veritas DMP.
The user can now proceed with importing any ZFS zpools
The following article outlines the steps for upgrading InfoScale 7.4.2.x:
How to upgrade to InfoScale 7.4.2.x and Solaris to 11.4 with Solaris zones using Alternate Boot Environments (ABE)
Issue/Introduction
How to upgrade InfoScale software and Solaris to 11.4 with Solaris zones using Alternate Boot Environments (ABE)
