Manual Chapter :
What disk size tasks should I perform before
an upgrade?
Applies To:
Show Versions
BIG-IQ Centralized Management
- 7.1.0, 7.0.0
What disk size tasks should I perform before
an upgrade?
Before you upgrade a
BIG-IQ® system you should make sure of a couple things
about the virtual disk on which your BIG-IQ system resides, so that all goes as planned when
you upgrade your software.
Questions to ask before you
upgrade
Do you have enough disk space on the BIG-IQ VE to install the BIG-IQ
software? | Before you create new slots and size them appropriately, you need to check
whether there is sufficient physical disk space on the VE. |
How big are the volumes needed by the software you want to install? | F5 has created a script that reads the size requirements from the software
image you plan to install. |
How big are the volumes on your current BIG-IQ installation? | You need to know the volume sizes for your current installation. If any of the
volumes have been extended, you must likewise extend the volumes on the installation
slot before you upgrade. Otherwise, the install process can result in loss of
data. |
Do you have an open slot to install the software on? | Before you can install new software, you need an open slot. |
Download disk size tools
F5 has created several scripts that
are useful if you need to resize your disk volumes as part of the upgrade process. On a
BIG-IQ® system or DCD with version 5.4.0 installed, these
scripts are available in the
/usr/bin
folder. Because this folder
is already in your path definition, you can use these scripts directly. To use these
scripts with BIG-IQ systems or DCDs running versions prior to version 5.4.0, you must
first download them. - Log in todownloads.f5.com.
- Navigate to BIG-IQ Centralized Management, v5.4.0, and clickI Acceptto accept the EULA.
- ClickF5_Networks_Disk_Size_Tools.zip.After a brief pause, the Download Locations screen opens.
- Click a download location to start the download.
- When the download completes, unzip the file.Three files will extract to the folder you designate:
- addvol
- imageplan
- resizevol
Before you can run these scripts, you need to copy them to the device you are
resizing.
Check the amount of free disk space on
your BIG-IQ VE
You need to check that there is
sufficient physical disk space on the BIG-IQ VE so that you can create new volumes and
size them appropriately.
- Use SSH to log in to your DCD asroot.
- Use thepvscommand to check how much disk space is available for new slots and volumes.[root@bigiq-console-test-large:Active:Standalone] ~ #pvsPV VG Fmt Attr PSize PFree /dev/sda3 vg-db-sda lvm2 a-- 498.50g 446.82gThe command response tells you how much free disk space is available.However, you also must consider how much space your current installation uses. If you have extended the size of the volumes for your current installation, you must consider that as well.This device has 446 Gigs of free disk space. That would be more than sufficient for a standard version 5.4 install (30G +5G + 5G + 10G = 50G).
If the amount of disk space
available is less than the amount you need so that you can install your software, you
must increase the free space before you can proceed. Refer to the hypervisor vendor
documentation for the workflow to increase the amount of available disk space on your
VE.
How do I get BIG-IQ to email me if disk
space is low?
To get an email if the BIG-IQ® VE runs low on disk space, you complete
three tasks:
- Specify an SMTP server to send email alerts.
- Set up email addresses for low disk space alerts.
- Set up a low disk space alert.
Specify an SMTP server to send email
alerts
You specify an SMTP server so F5
BIG-IQ® Centralized Management can send email to alert specified
people when a certain condition happens, such as when an SSL certificate is about to
expire.
- At the top of the screen, clickSystem.
- On the left, clickSMTP Configuration.
- On the SMTP Configuration screen, if there is no mail server set up, click theAddbutton.
- In theNamefield, type a name for this SMTP configuration.
- In theSMTP Server HostandSMTP Server Portfields, type the SMTP server and TCP port.By default, SMTP uses TCP 25.
- In theFrom Email Addressfield, type the email address from which to send the alert email.
- From theEncryptionlist, select the type of encryption to use for the email.
- To require a user name and password, from theUse Authlist, selectYes, and type the required user name and password.
- To verify that you can reach the server you configured, click theTest Connectionbutton.
- Click theSave & Closebutton.
You can now specify email recipients
and set up the alert conditions that prompt BIG-IQ to send an email when a certain event
happens on a managed device.
Set up email addresses for low disk space
alerts
Before you can set up the BIG-IQ® to email alerts, you need to have set up an SMTP mail
server.
You can add a list of email
recipients to which BIG-IQ sends notifications for low disk space alerts.
- At the top of the screen, clickSystem.
- On the left, click.
- Near the top of the screen, click theCreatebutton.
- In theNameandEmail Addressfields, type the name and email address of the person you want to receive the low disk space alert.
- In theDescriptionfield, you can type an optional description to help identify this user.
- Select the check box nextSystem Alerts.
- To add another email recipient, click+.
- Click theSave & Closebutton at the bottom of the screen to save your changes.
Set up a low disk space alert
You can set up an alert that sends
an email to notify you when disk space on the BIG-IQ® VE is
low.
- At the top of the screen, clickMonitoring.
- On the left, clickALERTS & NOTIFICATIONS.
- At the top of the screen, click theSettingsbutton.
- If the device you are managing is a BIG-IQ, under Disk Usage Alert Conditions, selectEnablednext to theBIG-IQ Used disk space is above threshold for a devicealert, then specify theThresholdat which you want to be notified.
- If the device you are managing is a BIG-IQ, under Disk Usage Alert Conditions, selectEnablednext to theUsed disk space is above threshold for a DCDalert, then specify theThresholdat which you want to be notified.
- Click theSave & Closebutton.
Check the amount of free disk space on
your BIG-IQ VE
You need to check that there is
sufficient physical disk space on the BIG-IQ VE so that you can create new volumes and
size them appropriately.
- Use SSH to log in to your DCD asroot.
- Use thepvscommand to check how much disk space is available for new slots and volumes.[root@bigiq-console-test-large:Active:Standalone] ~ #pvsPV VG Fmt Attr PSize PFree /dev/sda3 vg-db-sda lvm2 a-- 498.50g 446.82gThe command response tells you how much free disk space is available.However, you also must consider how much space your current installation uses. If you have extended the size of the volumes for your current installation, you must consider that as well.This device has 446 Gigs of free disk space. That would be more than sufficient for a standard version 5.4 install (30G +5G + 5G + 10G = 50G).
If the amount of disk space
available is less than the amount you need so that you can install your software, you
must increase the free space before you can proceed. Refer to the hypervisor vendor
documentation for the workflow to increase the amount of available disk space on your
VE.
Check the volume sizes required by the
software you want to install
Before you check the required volume
sizes using the
imageplan
script, you need to:- Confirm that theimageplanscript is on the device you plan to update. On a BIG-IQ® system or DCD with version 5.4.0 installed, these scripts are available in the/usr/binfolder. Because this folder is already in your path definition, you can use these scripts directly. To use these scripts with BIG-IQ systems or DCDs running versions prior to version 5.4.0, you must first download them. For details on downloading this script, refer toDownloading disk size toolsonsupport.f5.com.
- Download the software that you plan to install.
When you upgrade a BIG-IQ VE, you need to know the volume sizes required by the
software you plan to install. F5 has created a script that reads the size
requirements from the software image you plan to install. Use this script so you can
be confident that your VE volume sizes are sufficient before you upgrade your BIG-IQ
software.
- Use SSH to log in to the device you are going to upgrade as root.
- Copy the software image to the/shared/imagesfolder on the BIG-IQ system you plan to upgrade.#cp <big-iq-software-image>.iso /shared/images/<big-iq-software-image>.iso
- Run theimageplanscript on the software image to determine the file system sizes required.#./imageplan /shared/images/<big-iq-software-image>.isoproduct BIG-IQ version 5.3.0 build 0.0.1119 (BIGIQ530) selected Standard plan Mount point: /, Size: 450000k Mount point: /usr, Size: 3450000k Mount point: /config, Size: 3320000k Mount point: /var, Size: 10485760k Tiny plan Mount point: /, Size: 450000k Mount point: /usr, Size: 3450000k Mount point: /config, Size: 500000k Mount point: /var, Size: 10485760k
Now you know the size requirements
for the image you plan to install, but the slot you upgrade to must have volumes that
are at least as big as those on the slot that your software is currently installed on.
This is especially significant if you decided to extend one of the volumes on your
current installation. So if your
/var
volume is extended to 30G,
you must have at least that much space on the new slot before you install software. So
the next thing you need to do is check the size of your existing installation.Check the volume sizes on your current
BIG-IQ installation
When you upgrade a BIG-IQ® VE, you need to know the volume sizes
for your current installation, because if any of the volumes have been extended, you
must extend the volumes on the installation slot before you upgrade. Otherwise, the
install process can result in loss of data. To check the volume sizes of the
existing BIG-IQ installation, you can use a
tmsh
command. - Use SSH to log in (asroot) to the device you plan to upgrade.
- Use thetmshcommandshow sys softwareto check the volume sizes of the existing installation.[root@bigiq-test:Active:Standalone] config #tmsh show sys software---------------------------------------------------- Sys::Software Status Volume Product Version Build Active Status ---------------------------------------------------- HD1.1 BIG-IQ 5.2.0 0.0.5567 yes complete [root@bigiq-test:Active:Standalone] config # lvs --unit=k LV VG Attr LSize Pool Origin Data% Move Log Cpy%Sync Convert dat.log.1 vg-db-sda -wi-ao--- 7168000.00k dat.maint.1 vg-db-sda -wi-a---- 307200.00k dat.share.1 vg-db-sda -wi-ao--- 10240000.00k dat.swapvol.1 vg-db-sda -wi-ao--- 1048576.00k set.1._config vg-db-sda -wi-ao--- 503808.00k set.1._usr vg-db-sda -wi-ao--- 3452928.00k set.1._var vg-db-sda -wi-ao--- 31457280.00k set.1.root vg-db-sda -wi-ao--- 450560.00kThe system response shows you the volume sizes of your current installation. The key volumes with their sizes are listed below:
- /config(.5G)
- /usr(3.5G)
- /var(30G)
- /root(.5G)
The slot you upgrade to must have
volumes that are at least as big as those on the slot where your software is currently
installed. This is especially significant if you decided to extend one of the volumes on
your current installation. So if your
/var
volume is extended to
30G, you must have at least that much space available on the new slot, before you
install software.Create correctly sized volumes on the new
installation slot
Before you can use this workflow to
create new installation volumes, you need the
addvol
script on the BIG-IQ device you want to create the volumes on. - On a BIG-IQ system or Data Collection Device with version 5.4.0 installed, these scripts are available in the/usr/binfolder. Because this folder is already in your path definition, you can use these scripts directly.
- To use these scripts with BIG-IQ systems or DCDs running versions prior to version 5.4.0, you must first download them. For details on downloading this script, refer toDownloading disk size toolsonsupport.f5.com.
If you are planning to upgrade a
BIG-IQ VE, you can use the
addvol
script to create new volumes on the
BIG-IQ VE that are sized correctly for the version you plan to install.- Download the image file that you plan to install fromdownloads.f5.com.
- Use SSH to log in (asroot) to the device you plan to upgrade, and copy the image file to the/shared/imagesfolder.
- Use theaddvolscript to create the file systems defined in the image plan for the software you plan to install.The script creates the correctly sized volume, but does not install any software. In this example, the image file for BIG-IQ version 5.3.0 is used.#./addvol HD1.2 /shared/images/BIG-IQ-5.3.0.0.0.1119.isocreate volume HD1.2 for image /shared/images/BIG-IQ-5.3.0.0.0.1119.iso product BIG-IQ version 5.3.0 build 0.0.1119 (BIGIQ530) selected Creating new location sda, 2... info: zero sblock for member device; /dev/vg-db-sda/set.2.root info: zero sblock for member device; /dev/vg-db-sda/set.2._usr info: zero sblock for member device; /dev/vg-db-sda/set.2._config info: zero sblock for member device; /dev/vg-db-sda/set.2._var [root@bigiq-test:Active:Standalone] ~ # lvs --unit=k LV VG Attr LSize Pool Origin Data% Move Log Cpy%Sync Convert dat.log.1 vg-db-sda -wi-ao--- 7168000.00k dat.maint.1 vg-db-sda -wi-a---- 307200.00k dat.share.1 vg-db-sda -wi-ao--- 10240000.00k dat.swapvol.1 vg-db-sda -wi-ao--- 1048576.00k set.1._config vg-db-sda -wi-ao--- 503808.00k set.1._usr vg-db-sda -wi-ao--- 3452928.00k set.1._var vg-db-sda -wi-ao--- 30003200.00k set.1.root vg-db-sda -wi-ao--- 450560.00k set.2._config vg-db-sda -wi-a---- 3321856.00k set.2._usr vg-db-sda -wi-a---- 3452928.00k set.2._var vg-db-sda -wi-a---- 10485760.00k set.2.root vg-db-sda -wi-a---- 450560.00kThe script reads the image plan and creates new volumes for/config,/usr,/var, and/rootbased on the requirements defined in the plan.
Increase the size of a disk volume
Before you can increase the size of
the disk volumes on your BIG-IQ ®VE:
- You need theresizevolscript on the BIG-IQ VE on which you want to increase the size of the disk volumes.
- On a BIG-IQ system or DCD with version 5.4.0 installed, these scripts are available in the/usr/binfolder. Because this folder is already in your path definition, you can use these scripts directly.
- To use these scripts with BIG-IQ systems or DCDs running versions prior to version 5.4.0, you must first download them. For details on downloading this script, refer toDownloading disk size toolsonsupport.f5.com.
- You need to know the volume names that you want to extend and the size that you want to extend them to.
If you need to increase the volume size of a disk volume on your installation slot so
that you can install without losing any data, you can use the
resizevol
script. - Use SSH to log in to your DCD as root.
- Use SSH to log in (asroot) to the device you plan to upgrade.
- Use theresizevolscript to increase the size of the volumes for the new installation slot to the required size.The volume sizes required depend on these two factors:
- The volume sizes required by the software you want to install. For details, seeCheck the volume sizes required by the software you want to installonsupport.f5.com.
- The volume sizes your current installation uses. For details, seeCheck the volume sizes on your current BIG-IQ installationonsupport.f5.com.
Here is an example of theresizevolscript being used to resize the/varvolume to 30 GB.#./resizevol /var 30000000Requested size 30000000k is less than current size 30003200.00k on /dev/vg-db-sda/set.1._var, skipping Resizing logical volumes. OK (y/n)? y Requested size 30000000k is less than current size 30003200.00k, skipping e2fsck 1.41.12 (17-May-2010) Pass 1: Checking inodes, blocks, and sizes Pass 2: Checking directory structure Pass 3: Checking directory connectivity Pass 4: Checking reference counts Pass 5: Checking group summary information set.2./var: 11/655360 files (0.0% non-contiguous), 79696/2621440 blocks Rounding size to boundary between physical extents: 28.61 GiB Extending logical volume set.2._var to 28.61 GiB Logical volume set.2._var successfully resized resize2fs 1.41.12 (17-May-2010) Resizing the filesystem on /dev/vg-db-sda/set.2._var to 7500800 (4k) blocks. The filesystem on /dev/vg-db-sda/set.2._var is now 7500800 blocks long. # lvs --unit=k LV VG Attr LSize Pool Origin Data% Move Log Cpy%Sync Convert dat.log.1 vg-db-sda -wi-ao--- 7168000.00k dat.maint.1 vg-db-sda -wi-a---- 307200.00k dat.share.1 vg-db-sda -wi-ao--- 10240000.00k dat.swapvol.1 vg-db-sda -wi-ao--- 1048576.00k set.1._config vg-db-sda -wi-ao--- 503808.00k set.1._usr vg-db-sda -wi-ao--- 3452928.00k set.1._var vg-db-sda -wi-ao--- 30003200.00k set.1.root vg-db-sda -wi-ao--- 450560.00k set.2._config vg-db-sda -wi-a---- 3321856.00k set.2._usr vg-db-sda -wi-a---- 3452928.00k set.2._var vg-db-sda -wi-a---- 30003200.00k set.2.root vg-db-sda -wi-a---- 450560.00kThe script extends the size of the volume you specify (/varin this example) to be the size you want (30GB in this example).
Now that the volumes are correctly
sized, you can proceed with the installation.
Check to see if you have an open slot to
install the software on
In order to install new software, you need an open slot. You can use a
bash
command to determine whether your BIG-IQ ® VE has any open slots.- Use SSH to log in, asroot, to the device you are upgrading.
- Use thelvscommand to determine how many slots there are on your BIG-IQ VE.#lvs --unit=kLV VG Attr LSize Pool Origin Data% Move Log Cpy%Sync Convert dat.log.1 vg-db-sda -wi-ao--- 8388608.00k dat.maint.1 vg-db-sda -wi-a---- 307200.00k dat.share.1 vg-db-sda -wi-ao--- 33554432.00k dat.swapvol.1 vg-db-sda -wi-ao--- 1048576.00k set.1._config vg-db-sda -wi-a---- 503808.00k set.1._usr vg-db-sda -wi-a---- 3452928.00k set.1._var vg-db-sda -wi-a---- 10485760.00k set.1.root vg-db-sda -wi-a---- 450560.00k set.2._config vg-db-sda -wi-ao--- 3481600.00k set.2._usr vg-db-sda -wi-ao--- 3584000.00k set.2._var vg-db-sda -wi-ao--- 16003072.00k set.2.root vg-db-sda -wi-ao--- 512000.00k set.3._config vg-db-sda -wi-a---- 3321856.00k set.3._usr vg-db-sda -wi-a---- 3452928.00k set.3._var vg-db-sda -wi-a---- 10485760.00k set.3.root vg-db-sda -wi-a---- 450560.00kEach instance ofset.nrepresents a slot on the VE. So in this example, the VE has three installation slots (set.1, set.2, and set.3).
If the BIG-IQ VE has only one slot,
then you need to add an new slot when you install the upgrade.
Install BIG-IQ to a new slot
Before you can install a BIG-IQ ® device to a new slot, you must have:
- Downloaded the software image fromF5.downloads.com.
- Correctly sized the volumes on the slot you plan to install the new version on.
On a BIG-IQ system or DCD with version 5.4.0 installed, you can use the user
interface to add a new volume as part of the upgrade process,With BIG-IQ systems or
DCDs running versions prior to version 5.4.0, you can upgrade BIG-IQ using a
tmsh
command.
The process performs these steps:- Creates a UCS backup from the current system and saves it in the/sharedfolder.
- Installs a new BIG-IQ image on a new slot.
- When the new image is installed on the new slot, it copies that data was saved in/sharedinto the new database running on the new slot.
- Use SSH to log in to your BIG-IQ as root.
- Use thetmshinstallcommand to upgrade your software.The following example uses the create-volume parameter so the process creates a new slot and then begins installing the software on it.# tmsh install sys software image BIG-IQ-5.3.0.0.0.1119.iso create-volume volume HD1.2The process upgrades your BIG-IQ system and restores the data from the current version.
- After the installation is complete, you can use thetmshshow sys softwarecommand to check to see that the upgrade was successful and that the/varfile system is the correct size (30M).# tmsh show sys software ---------------------------------------------------- Sys::Software Status Volume Product Version Build Active Status ---------------------------------------------------- HD1.1 BIG-IQ 5.2.0 0.0.5567 yes complete HD1.2 BIG-IQ 5.3.0 0.0.1119 no complete # lvs --unit=k LV VG Attr LSize Pool Origin Data% Move Log Cpy%Sync Convert dat.log.1 vg-db-sda -wi-ao--- 7168000.00k dat.maint.1 vg-db-sda -wi-a---- 307200.00k dat.share.1 vg-db-sda -wi-ao--- 10240000.00k dat.swapvol.1 vg-db-sda -wi-ao--- 1048576.00k set.1._config vg-db-sda -wi-ao--- 503808.00k set.1._usr vg-db-sda -wi-ao--- 3452928.00k set.1._var vg-db-sda -wi-ao--- 30003200.00k set.1.root vg-db-sda -wi-ao--- 450560.00k set.2._config vg-db-sda -wi-a---- 3321856.00k set.2._usr vg-db-sda -wi-a---- 3452928.00k set.2._var vg-db-sda -wi-a---- 30003200.00k set.2.root vg-db-sda -wi-a---- 450560.00k