Manual Chapter :
What disk size tasks should I perform before an upgrade?
Applies To:
Show VersionsBIG-IQ Centralized Management
- 8.3.0, 8.2.0, 8.1.0, 8.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
Question |
Comment |
---|---|
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? |
Use the F5 script to determine 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 6.0 or later 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 version 8.0.0, you must first download them. Complete the following steps to download these scripts.
- Log in todownloads.f5.com.
- Navigate to BIG-IQ Centralized Management, look for the BIQ-IQ release you are working with, and clickI Acceptto accept the EULA.
- ClickF5_Networks_Disk_Size_Tools.tar.After a brief pause, the Download Locations screen opens.
- Click a download location to start the download.
- When the download completes, extract the contents of the archive.Three files will extract:
- addvol
- imageplan
- resizevol
Before you can run these scripts, you need to
copy them to the
/usr/bin
folder of
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 theAddbutton.
- 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 disk volume size required by the BIG-IQ software
upgrade
Before you check the required disk volume
size:
- Upload the BIG-IQ software to the BIG-IQ you are upgrading.
- Confirm that theimageplanscript is on the BIG-IQ you plan to upgrade.This script is located in the/usr/binfolder. Because this folder is already in your path definition, you can initiate this script directly.
The
var
partition must be at least 2.5 times larger than it needed to be for earlier BIG-IQ
version. When you upgrade BIG-IQ, you can use the size requirements from the software
image you plan to install so you can be confident that your disk volume sizes are
sufficient before you upgrade your BIG-IQ.- From the command line, use SSH to log in (asroot) to the BIG-IQ you are going to upgrade.
- Copy the software image to the/shared/imagesfolder on the BIG-IQ you plan to upgrade by typing the following command:#cp <big-iq-software-image>.iso /shared/images/<big-iq-software-image>.isoBIG-IQ returns output reflecting the sizing requirements for this upgrade.If you are running the Web Application Security service, and are upgrading from BIG-IQ version 7.1, or earlier: Improvements to signature management requires additional disk storage per policy. Each Web Application Security policy managed by BIG-IQ requires an additional 20MB in/varfile. To add storage, seeIncrease the size of a disk volume.
Now you know the size requirements for the
image you plan to install.
Check the volume sizes on your current BIG-IQ
installation
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. 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. Otherwise, the install
process can result in loss of data. - Use SSH to log in (asroot) on the BIG-IQ 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 7.1.0 0.0.1511 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)
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 DCD with version 6.0 or later 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 version 8.0.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 7.1.0 is used.#./addvol HD1.2 /shared/images/BIG-IQ-7.1.0.0.0.1511.isocreate volume HD1.2 for image /shared/images/BIG-IQ-7.1.0.0.0.1511.iso product BIG-IQ version 7.1.0 build 0.0.1511 (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 6.0 or later 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 version 8.0.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 (asroot) to the device you plan to upgrade.
- Shut down BIG-IQ by typing:shutdown -h now
- Provision the disk space you need for the BIG-IQ VE system.
- Start up the BIG-IQ VE guest instance.For information about disk starting a guest instance, refer to the documentation from your hypervisor or cloud vendor.
- 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). - Save the configuration changes by typing:tmsh save /sys config
- Restart BIG-IQ by typing:reboot
- When the BIG-IQ restarts, use SSH to log in (asroot). Verify the directory was successfully extended to the size you specified by typing the tmsh command:tmsh show /sys disk directoryFor more information about extending the disk space on a BIG-IQ, refer to K30902515.
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
To
install new software, you need an open slot. You can use a
bash
command to
determine whether your BIG-IQ 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.#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 a new slot when you install the
upgrade.
Use TMSH to 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.
This task explains how to use a
tmsh
command to
install BIG-IQ software to a new volume as part of the upgrade
process 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-7.1.0-0.0.1511.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 6.1.0 0.0.1224 yes complete HD1.2 BIG-IQ 7.1.0 0.0.1511 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