Manual Chapter : Common elements: Software Management

Applies To:

Show Versions Show Versions

BIG-IQ Centralized Management

  • 7.1.0
Manual Chapter

Common elements: Software Management

You must have a base registration key to license the BIG-IQ system. If you do not have a base registration key, contact the F5 Networks sales group (
http://www.f5.com
).
The default size of the
/var
file system in a newly installed logging node is 30 GB. This volume size might be insufficient to store logging data. You can see how to extend this file system to a larger size in knowledge article K16103. Refer to:
K16103: Extending disk space on BIG-IQ Virtual Edition
at
support.f5.com/csp/article/K16103
. Because upgrading a logging node installation requires at least two volumes, make sure both volumes can have their
/var
file system extended to the same size, or upgrades might fail.
If the machine you are upgrading does not have two volumes, you must create one using the command line interface. The following steps provide options for either case.
  1. On the left, click
    SOFTWARE MANAGEMENT
    IMAGES
    .
  2. Select the image you want to upload and click the
    Upload Image
    button.
  3. On the left, click
    THIS DEVICE
    SOFTWARE MANAGEMENT
    Installations
    .
  4. On the left, click
    SOFTWARE MANAGEMENT
    Software Images
    .
  5. On the left click
    SOFTWARE MANAGEMENT
    Software Installations
    .
  6. On the left, click
    SOFTWARE MANAGEMENT
    Legacy Upgrades
    .
  7. On the left, click
    SOFTWARE MANAGEMENT
    .
  8. On the left, click
    Software Management
    Available Images
    .
  9. Click the
    Upgrade
    button.
  10. On the left, click
    Upgrade
    .
    A popup screen notifies you that you are about to upgrade this BIG-IQ system and all of the devices in the associated DCD cluster. Click
    Continue
    to proceed.
  11. On the left, click
    Software Version
    .
  12. Click the
    Update
    button.
  13. Click the
    Upload Image
    button.
  14. Click the
    Choose File
    button and go to the location to which you downloaded the image, and click the
    Open
    button to upload it to BIG-IQ.
  15. Click the
    Upload
    button.
    The screen refreshes to display the progress of the upload.
  16. In the
    Software Images
    list, select the check box next to the image you want to install, and click the
    Managed Device Install
    button located at the top of the screen.
  17. In the
    Software Images
    list, select the check box next to the image you want to install, and click the
    Legacy Device Install
    button at the top of the screen.
  18. Select the check box next to the image you want to install and click the
    Install
    button.
  19. In the list of images, select the check box next to the image you want to install, and click the
    Install
    button at the top of the screen.
  20. From the
    Software Image
    list, select the image you want to install.
  21. In the
    Name
    field, type a name to identify this installation.
  22. Select the
    Back up the BIG-IP system before upgrade
    check box.
  23. For the
    Options
    setting, you can enable one or more of the following by selecting the check box next to it:
    If you select an option to pause at any point during before, during, or after the installation process, you'll need to click the
    Continue
    button to move on to the next step.
    • Perform pre and post installation assessment
      and select the managed objects you want to assess the state of, before and after upgrading, so you can investigate if any difference are found.
    • Perform backups
      and select the
      Backup Properties
      options for the backup.
    • Pause after the software image is copied has been copied to devices
      if you want to copy the image to this device, but wait until later to install it.
    • Pause for reboot confirmation
      to pause before rebooting the devices after the software is installed.
    • Install devices one by one
      for DNS sync group upgrades.
      Because the upgrades occur sequentially when you choose this option, when the installation finishes for the last device, all of the devices in the sync group are at the same software version, and the sync group can be brought back online.
  24. From the
    Target Volume
    list, select the volume you want to install the image on.
  25. From the
    Target Volume
    list, select the volume you want to install the image on.
    If the Target Volume list is empty, the machine you are upgrading does not have a second volume available for you to install the upgrade. You must create one to proceed.
    • If you selected a target volume, complete the remaining steps to finish the upgrade.
    • If you do not have a second volume, use the following procedure to install the upgrade for this machine:
      • Use SSH to log in to the machine you want to upgrade. You must log in as
        root
        to perform this procedure.
      • Navigate to the folder where you install software using the command:
        cd /shared/images
      • Install the upgrade to a new volume using one of the following commands:
        • If you are upgrading a virtual machine:
          tmsh install sys software image <full name of the iso file> volume hd1.2 create-volume reboot
        • If you are upgrading a BIG-IQ 7000 series platform:
          tmsh install sys software image <full name of the iso file> volume md1.2 create-volume reboot
      • While the system installs the upgrade to the new volume, you can check on the status of the upgrade using the command:
        tmsh show sys software status
        .
      • When the upgrade finishes installing, the machine reboots. Proceed to the next to the last (login) step in this task.
  26. Under Devices, for each listed BIG-IP device and DCD, specify the
    Target Volume
    list, select the volume you want to install the image on for each device in the cluster.
    You can either choose an existing (inactive) volume, or create a new volume. If the
    Target Volume
    list is empty, the machine you are upgrading does not have a second volume available for you to install the upgrade. You must create one to proceed.
    • To install to an existing volume, select
      Target Volume
      , then click
      Select
      , and select the volume for the upgrade.
    • To install to a new volume, select
      New Volume
      , and type the new volume name.
  27. From the
    Target Volume
    list, select the volume you want to install the image on.
    You can either choose an existing (inactive) volume, or create a new volume. If the
    Target Volume
    list is empty, the machine you are upgrading does not have a second volume available for you to install the upgrade. You must create one to proceed.
    • To install to an existing volume, select
      Target Volume
      and select the volume for the upgrade.
    • To install to a new volume, select
      New Volume
      , and type the new volume name.
  28. From the
    Target Volume
    list, select the volume you want to install the image on.
    If the
    Target Volume
    list is empty, the machine you are upgrading does not have a second volume available for you to install the upgrade. You must create one to proceed.
    • If you selected a target volume, complete the remaining steps to finish the upgrade.
    • If you do not have a second volume, use the following steps to create one:
      • Use SSH to log in to the machine you want to upgrade. You must log in as
        root
        to perform this procedure.
      • Create the new volume using the command
        /usr/libexec/bigpipe software desired <volume name> add
        , for example:
        /usr/libexec/bigpipe software desired HD1.3 add
        .
      • After the command runs, repeat this step; however, this time the
        Target Volume
        list will not be empty.
  29. If you are upgrading devices that belong to a DNS sync group, decide how you are going to choose devices for upgrade:
    • To use the sync group name, select
      Group/Cluster
      , and then select
      DNS Sync Group
      .
    • To use the host names for individual devices, select
      Device
      .
  30. Click the
    Add/Remove Devices
    button to select devices to install this software on.
  31. From the
    Available
    list, select the device(s) you want to upgrade, move it to the
    Selected
    list, and click the
    Apply
    button.
    If you select a device that belongs to a DNS sync group, you must also select all of the other members of the group, to continue the upgrade.
  32. To set the location for where BIG-IQ installs this software image:
    1. Click the
      Set Default Volume
      button.
    2. Select
      Volume Name
      .
    3. In the
      Volume Name
      field, type the name of the volume on which you want to install this image.
    4. Click the
      Apply
      button.
  33. Click the
    Run
    button towards the middle of the screen to put the image on the BIG-IP device(s) immediately.
    Alternatively, you can click the
    Save & Close
    button to save this job to deploy the software later.
  34. If you selected the option to back up the BIG-IP device(s) before installing the software, when BIG-IQ pauses, click the
    Back Up Devices
    button.
  35. If you selected the option to run a pre-installation assessment, when BIG-IQ pauses:
    1. Click the
      Run Pre-assessment
      button.
    2. Select the configurations that you want BIG-IQ to review before upgrading and click the
      OK
      button.
    3. When the assessment is complete, click the
      Continue
      button to start the installation.
  36. If you selected the option to pause before the software is installed, click the
    Continue
    button to install the software.
  37. To run a post-installation assessment, click the
    Run Post-assessment
    button.
  38. To compare the pre- and post-upgrade assessments, click the
    Compare Assessments
    button.
  39. If you selected the option to back up the BIG-IP device(s) after installing the software, click the
    Back Up Devices
    button.
  40. If you selected the option to pause before rebooting the BIG-IP device after the software is installed, click the
    Continue
    button to reboot.
  41. To run a post-installation assessment, click the
    Run Post-assessment
    button.
  42. To compare the pre-upgrade assessment and the post-upgrade assessment, click the
    Compare Assessments
    button towards the bottom of the screen, and click the
    Mark Finished
    button when it's done.
  43. On the left, click
    BIG-IQ DEVICES
    BIG-IQ HA
    .
  44. Select the
    Update
    check box.
  45. To prompt BIG-IQ to reboot into the new software installation volume, select the
    Reboot into Target Volume
    check box.
  46. To prompt the data collection device to reboot into the new software installation volume, select the
    Reboot into Target Volume
    check box.
  47. To prompt the logging node to reboot into the new software installation volume, select the
    Reboot into Target Volume
    check box.
  48. Wait while the logging node loads the new software and reboots.
    Depending on your configuration and the number of devices you are managing, this could take up to 15 minutes. During this time, it is important that you do not interrupt the installation process by restarting services or the server.
  49. Click the
    Apply
    button.
    A popup screen opens, prompting you to confirm the installation.
  50. Click the
    Continue
    button.
  51. Wait while BIG-IQ loads the new software and reboots.
    Depending on your configuration and the number of devices you are managing, this could take up to an hour. During this time, it is important that you not interrupt the installation process by restarting services or the server.
  52. Wait while the data collection device loads the new software and reboots.
    Depending on your configuration and the number of devices you are managing, this could take up to 15 minutes. During this time, it is important that you not interrupt the installation process by restarting services or the server.
  53. Log in to the BIG-IQ that will be the secondary BIG-IQ system to confirm that the upgrade succeeded and complete the setup wizard.
    To complete the setup task, you must supply a master key pass phrase that all devices in the DCD cluster must share. Make note of the phrase you use. Each logging node, as well as the primary and secondary BIG-IQ systems must use this phrase before they can join the cluster.
  54. Log in to the BIG-IQ that will be the secondary BIG-IQ system to confirm that the upgrade succeeded.
  55. Log in to the primary BIG-IQ to confirm that the upgrade succeeded.
  56. If the License Feature Selection popup screen opens, select
    BIG-IQ Central Management Console
    , and then click
    OK
    .
    This choice cannot be undone. Once you license a device as a BIG-IQ Management Console, you cannot change your mind and license it as a data collection device.
  57. Click the
    Next
    button to move through the rest of the BIG-IQ System Setup screens.
  58. At the last setup screen, click the
    Done
    button.
  59. Click the
    Install
    button at the bottom of the screen.
  60. If needed, extend the
    /var
    partition.
    The default size of the
    /var
    file system in a newly installed or upgraded node is 30 GB. This amount of available storage might not be enough to store your data. If you previously extended your disk space, you'll need to do it again after you upgrade. For information about how to do that, refer to: K16103: Extending disk space on BIG-IQ Virtual Edition And remember, upgrading a node requires at least two volumes, so be sure you can extend the
    /var
    file system on both volumes to the same size, or upgrades might fail.
When BIG-IQ uploads the software, it verifies the image. This verification process can take several minutes. When BIG-IQ is finished uploading and verifying the image, the software image displays as
Verified
and is available for installation on a device.