Applies To:

Show Versions Show Versions

Manual Chapter: Enterprise Manager Administrator Guide: Managing Software Images
Manual Chapter
Table of Contents   |   << Previous Chapter   |   Next Chapter >>


5

Managing Software Images


Managing software images

Installing a software or hotfix upgrade on individual devices can be a time-consuming task involving downloading an upgrade image, logging on to individual devices, configuring each upgrade task, and monitoring the job as it completes.

With Enterprise Manager as your software image management system, you can catalog and store several versions of software and hotfixes on the Enterprise Manager system, and use these images to perform upgrades to as many managed devices in the network as necessary.

By storing and cataloging all upgrade images in one location, the central repository makes it easier to manage the upgrading of a wide range of managed devices in the network.

After you add software images to the repository, you can then deploy software and hotfix images from the repository to one or more managed devices in the network.

When you set up an automated upgrade process, you can elect several options such as choosing the install location and reboot location. Once you start an upgrade task, you can monitor the progress of each device upgrade on the task list.

Working with the software repository

The Enterprise Manager software repository provides a central location where you can store all software upgrade and hotfix installation images. Once you download software or hotfix images from the F5 Networks FTP server, you can store all of the necessary images in the Enterprise Manager repository, enabling you to more efficiently manage the upgrading of devices in the network.

Adding software images to the repository

From the Enterprise Management screen, you can view and deploy multiple software images to as many managed devices in the network as you require.

If additional images become available, you can add them to the software repository for deployment at a later time.

Each image that you add to the repository includes an MD5 signature that you can use to manually check the validity of the software image.

 

 

Figure 5.1 The software image list displays the software images stored in the Enterprise Manager software repository

To add software to the software image list

Once you download a software image from the F5 Networks FTP server to your Enterprise Manager system, you can add it to the software repository.

  1. On the Main tab of the navigation pane, expand Enterprise Management, and click Software.
    The Software Images screen opens, displaying all available software update packages.
  2. Above the software image list, click Import.
    The Import Software Updates screen opens.
  3. In the File Name box, click Browse to search for the image using a directory or folder view.
  4. After you enter the path and file name, click Import.
    The Software Update List opens and the image name appears in the list with the status of Importing. When the importation completes, you can deploy the software to managed devices.
Important

When you import a software image, you must leave the browser window open on the file import screen. If you close the window or navigate away from the import screen, this terminates the file transfer. If you need to perform other management tasks, you can open a new browser window.

To add hotfix images to the hotfix list

You manage hotfixes on a separate list from the software upgrade list, but you import hotfix images in a similar fashion.

  1. On the Main tab of the navigation pane, expand Enterprise Management, and click Software.
    The Software Images screen opens, displaying all available software update packages.
  2. On the menu bar, click Hotfixes.
    The Software Hotfixes screen opens, displaying all available hotfix update packages.
  3. Click Import.
    The New Hotfix screen opens.
  4. In the File Name box, click Browse to search for the image using a directory or folder view.
  5. After you enter the path and filename, click Import.
    The Hotfix List opens and the image name appears in the list with the status of Importing. When the importation completes, you can deploy the hotfix to managed devices.
Important

When you import a hotfix image, you must leave the browser window open on the file import screen. If you close the window or navigate away from the import screen, this terminates the file transfer. If you need to perform other management tasks, you can open a new browser window.

Removing images from the software repository

If you no longer need to keep software or hotfix images in the software repository, you can delete them from their respective list screens. Once you remove an image from the list, Enterprise Manager deletes the image from its database. If you need to deploy this image in the future, you must re-import it to the software repository.

 

To delete software or hotfix images

From the software image list, or the hotfix image list, check the box to the left of the image name and click Delete below the list.
After you confirm the deletion, Enterprise Manager deletes the software or hotfix image from its database and removes it from the image list.

Installing software on managed devices

Using Enterprise Manager, you can deploy software or hotfix images to multiple managed devices in the network. Instead of logging on to each individual device, you can configure Enterprise Manager to upgrade multiple devices in a software upgrade task. A software upgrade task is a series of jobs that you configure to upgrade managed devices with software stored in the Enterprise Manager software repository. Each job consists of one individual device upgrade.

A software upgrade wizard streamlines the task of software upgrades while providing enough flexibility so that you can set custom options on each device you plan to upgrade. The wizard guides you through the process of selecting devices to upgrade, including which of the upgrade image or hotfixes to install, which boot location is upgraded, and which boot location is used during the reboot.

You can use the device groups feature to further enhance the upgrade process in that you can deploy a software or hotfix upgrade to an entire device group at once. Then, all of the members of the device group are upgraded during the upgrade task.

Working with multiple boot locations

BIG-IP systems feature a multiple boot capability, which means that you can install the software on multiple disk boot locations on each managed device. A boot location is a portion of a drive with adequate space required for a software installation (this was previously referred to in other documentation as a boot slot). The BIG-IP 1500 (C36), BIG-IP 3400 (C62), and BIG-IP 6400 (D63) platforms support this functionality, and if you manage any of these systems with Enterprise Manager, you can select the boot location for software upgrades when configuring an upgrade task.

Installing software to high availability systems

To minimize the risk when performing a installation to a system in a high availability configuration, we recommend that you configure only one device in the pair per upgrade task. For example, for an active-standby pair, instead of adding both the active and standby devices to the installation list when configuring the task, upgrade only the software on the standby device. Then, when the upgrade completes, you can switch the device to active mode to test whether the upgrade works properly. Once you confirm that the upgrade works as expected, you can configure a task to upgrade the second device of the pair.

Important

If you include both the active and standby systems in the same upgrade task and the upgrade does not work properly on the first device of a high availability pair, you cannot cancel the upgrade on the second device.

Installing software on devices in a tiered configuration

Although Enterprise Manager supports a network topology that features a tiered configuration where a top-tier BIG-IP system load balances requests to multiple lower-tier BIG-IP systems, the software upgrade wizard does indicate which devices exist on which tier.

If your network topology features a tiered configuration, we recommend that you do not schedule devices on both tiers for upgrade in the same upgrade task. This ensures that Enterprise Manager can maintain a connection to all devices in the network throughout an upgrade task.

Installing software on Enterprise Manager systems

In addition to installing software and hotfixes on managed devices, you can install software and hotfixes to Enterprise Manager systems, including the system you are working on. This means that Enterprise Manager can upgrade itself, as long as you added Enterprise Manager software to the software repository.

When you configure a software upgrade or hotfix installation task, any Enterprise Manager systems in your network appear among the list of devices that you can upgrade (if you elected to discover Enterprise Manager devices in the network). You can configure an upgrade task for Enterprise Manager in the same way that you do for any managed device.

Note

Certain options may not be available when you are configuring an Enterprise Manager system for a software upgrade task. For example, if you are installing software on the same system on which you are configuring the upgrade task, you cannot specify a different boot location. Consequently, you may notice that some options are not available when configuring a self-install task.

Performing software version rollbacks

Although the name suggests otherwise, you can use the software upgrade wizard to install previous versions of software on managed devices in the network.

You can configure software version rollbacks, or downgrades, in the same way that you configure software upgrades. However, because of the way the software management process operates, this may cause issues during a software downgrade.

After a typical software installation, Enterprise Manager applies the current device configuration to the newly installed software. After a downgrade task, it is possible that the current device configuration is no longer compatible with the software version. Because of this, we recommend that you manually reconfigure the device after completing a downgrade task.

Installing software to one or more devices

The simplest method of installing software to a device is through the software upgrade wizard. The software upgrade wizard provides four steps to guide you through all the configuration options necessary to start an upgrade task. When you perform a software upgrade, you have the option to include hotfixes in addition to the software.

To start a software image upgrade task

  1. On the Main tab of the navigation pane, expand Enterprise Management, and click Software.
    The Software Images screen opens, displaying all available software update packages.
  2. On the menu bar, click Installation.
    The software update wizard opens, prompting you to choose a software upgrade or hotfix-only installation.
  3. Select Software Upgrade and click Next.
    The Step 1 of 4 screen opens where you select devices to install to, and the software image to install.
  4. Follow the steps on the following pages to work through the wizard screens to install software upgrades.
Note

If you want to install hotfixes only, select Hotfix Installation and click Next. See Installing hotfixes to one or more devices on page 5-9 for information on installing hotfixes.

 

 

Figure 5.2 You can select software and devices in Step 1 of the software upgrade wizard

To select a software image and devices for the upgrade task

You can select a software image to install, and the devices to install the image to, in Step 1 of 4 of the software upgrade wizard.

  1. In the Device Group box, select an option to narrow the list of devices:
    • If you want to install to a device group, select the device group name.
    • If you want to install to specific devices, select All Devices to see a list of all devices compatible with the upgrade image you select.
  2. In the Software Image box, select the version that you want to use to upgrade devices.
    The Compatible Devices table changes to show only devices that you can upgrade with the image you selected.
  3. In the Devices box, choose to display which devices are compatible, or which devices are not compatible, with the software image you selected in the Compatible Devices table,
    The Compatible Devices table changes based on the option you select.
  4. In the Compatible Devices table, check the Select box to the left of the devices that you want to upgrade with the software you selected in the Software Image box.
  5. To move to the Step 2 of 4 screen, where you can select any hotfixes that you want to install during the upgrade, click Next.
Note

If a device does not appear in the Compatible Devices table, check the software version on the device to ensure that you can use the software image you selected for an upgrade.
Note

If a software image does not appear in the Software Image box, ensure that the image was imported correctly. You can view this information on the Software Images screen.

To select hotfix upgrades to include in the upgrade task

You can select hotfix images to include in the upgrade process in Step 2 of 4 of the software upgrade wizard. This screen displays available hotfixes that are compatible with the software you selected on the previous screen.

  1. In the hotfix table, check the Select box to the left of one or more hotfixes that you want to install during this upgrade.
    Note: If no hotfixes appear in the table, there are no available hotfixes in the Enterprise Manager repository that are compatible with the software you selected. It is possible that you may not have imported a compatible hotfix image to the software repository.
  2. To move to the next screen, where you can select installation and task options, click Next.

To select installation and task options for the upgrade task

You can specify the install location and select a reboot option in Step 3 of 4 of the software upgrade wizard.

  1. In the Install Location list, select where you want to install the software upgrade.
    The default is any empty boot location, or the location that hosts the oldest installed software version. If you select Active Location, the new software is installed over the software on the currently active boot location.
  2. In the Post Installation list, select which boot location to use for rebooting the device upon completion of the upgrade process.
  3. To move to the Step 4 of 4 screen, where you can review the details of the upgrade task you configured, click Next.
Note

If you do not select to reboot the managed device using the new software installation, the device reboots using the current default location, which may not be the same as the install location.

 

 

Figure 5.3 You can review the upgrade options in Step 4 of the software upgrade wizard

To review the details of the upgrade task

You can review the details of the upgrade task you just configured in Step 4 of 4 of the software upgrade wizard. The Task Details table list the devices selected for upgrade, the current boot location on each device, the install location you selected, and the location that the device will boot to when the upgrade process completes.

  1. Review the information on the table.
  2. If you want to adjust any options for a specific device, click the Edit link to the right of the device boot location information.
    The edit task general properties screen opens, allowing you to change the install or reboot location for the device.
  3. When the details look correct, click Start Task below the list.
    The Task Properties screen opens, displaying details relevant to the task that you configured.

To open the task list screen

The task properties screen displays information about the task you started, including a detailed list of all the devices you configured a software upgrade on, and the progress of each installation.

    • Below the Task Properties table, click the Exit to Task List button.
      The task list screen opens, displaying a list of all running tasks on the Enterprise Management system.

Installing hotfixes to one or more devices

Because you may install hotfixes on devices in your network more often than you install full software upgrades, it is important to have a simple method of deploying hotfixes to many devices at once. You can use the hotfix installation wizard to create a hotfix installation task. A hotfix installation task is a series of jobs that you configure to upgrade one or more managed devices with hotfixes stored in the Enterprise Manager hotfix repository. Each job consists of one individual hotfix installation per device. When you install hotfixes to one or more devices, you can only install on a managed device's currently active boot location.

To start a hotfix installation task

  1. On the Main tab of the navigation pane, expand Enterprise Management, and click Software.
    The Software Images screen opens, displaying all available software update packages.
  2. On the menu bar, click Hotfixes.
    The Software Hotfixes screen opens, displaying all available hotfixes.
  3. Verify that the hotfix that you want to install is available in the list, then on the menu bar, click Installation.
    The software update wizard opens, prompting you to choose a software upgrade or hotfix-only installation.
  4. Select Hotfix Installation and click Next.
    The Step 1 of 3 screen opens where you select the hotfix images to install.
Important

If the hotfix image that you want to install is not available in the hotfix list, you may need to import it. See Adding software images to the repository on page 5-1 .

To select a hotfix image to install

You can select a hotfix image in Step 1 of the hotfix installation wizard.

  1. From the Product Version list, select the product version that the hotfix you are planning to install applies to.
    The Available Hotfixes table changes to display hotfixes compatible with the software version you selected.
  2. In the Available Hotfixes table, check the Select box to the left of any hotfix that you want to install.
  3. To move to the next screen where you select devices to install the hotfix to, click Next.

To select devices to install the hotfix to

You can select which devices to install the hotfix to in Step 2 of the hotfix installation wizard.

  1. In the Device Group list, if you want to install to a device group, select the device group name, otherwise select All Devices to see a list of all devices compatible with the hotfix you selected.
  2. In the Compatible Devices table, check the Select box to the left of the devices that you want to upgrade with the hotfixes you selected on the Step 2 of 3 screen.
  3. To move to the last screen, where you can review the options you set in this hotfix upgrade task, click Next.
Note

If a device does not appear in the Compatible Devices table, check the software version on the device to ensure that you can use the hotfix.

To review hotfix installation options

You can review and elect to remove a device from the hotfix installation task in Step 3 of the hotfix installation wizard.

  1. Review the information on the table.
  2. If you want to remove a device from the install task:
    1. Click the Edit link to the right of the device boot location information.
      The device task general properties screen opens
    2. Below the Task Details table, click the Remove button.
      The Scheduling Review screen opens after you confirm the removal of the device from the hotfix installation task.
  3. When the details look correct, click the Start Task button below the list.
    The Task Properties screen opens, displaying details relevant to the task that you configured.

To open the task list screen

The task properties screen displays information about the task you started, including a detailed list of all the devices you configured a hotfix installation on, and the progress of each installation. The section Monitoring software and hotfix tasks provides additional information about the task list and how to work with tasks in the list.

    • On the Task Properties screen, below the Task Properties table, click the Exit to Task List button.

Monitoring software and hotfix tasks

When you start a software upgrade or hotfix installation, the task properties screen appears automatically to give you details of how much of the task is complete, and if the process is successful. You can also view an overview of the tasks running, or the details of a particular task.

The task list displays an overview of all tasks on Enterprise Manager, including running and completed tasks. When all the install or upgrade jobs in a task finish, the task name and description remains in the task list until you delete it.

Working with software upgrades on the task list

Once you start a software upgrade or hotfix installation, the task is added to the Enterprise Manager task list. If you start more than one upgrade task, additional tasks also appear in the task list.

The progress bar on the task list indicates the overall progress of the task. For example, if you scheduled ten devices for a hotfix installation, the progress bar will indicate 60% when 6 of those devices have completed the hotfix installation.

If you click the name of a task, the task properties screen opens, giving additional details about a task, and providing the opportunity to cancel any pending installations remaining in the task. See the following section for information about modifying a running task.

Once a task finishes, and you no longer need a record of the task, you can delete the task from the task list.

To delete a task from the task list

  1. On the Main tab of the navigation pane, expand Enterprise Management, and click Tasks.
    The Task List screen opens, displaying all running tasks in Enterprise Manager.
  2. Check the box to the left of the task that you want to delete, and click Delete below the list.
    The task is removed from the list, and the record is deleted from the Enterprise Manager database.

Cancelling pending tasks

You can cancel pending jobs in tasks that are already running by using the task properties screen. Whenever you start a software upgrade or hotfix installation task, the task properties screen opens. Alternately, you can click a task name in the task list to open the task properties screen.

The task properties screen displays details about a running task. For example, if you start an upgrade task on 10 devices, the properties screen displays the overall process and the progress per device.

 

 

Figure 5.4 The task properties screen displaying details of a software upgrade with hotfix installations.

To cancel pending upgrade tasks

On the task properties screen, click the Cancel Pending Items button below the task summary table(s).
After the current device completes its upgrade, Enterprise Manager cancels any software installations or hotfix upgrades for all devices listed in the Task Summary table as Pending.

Important

You cannot cancel an upgrade once the individual upgrade job starts.

To view details of a specific upgrade or installation

On the task properties screen, in a task summary table, click the Details link to the right of any software upgrade or hotfix installation job.
The task details screen opens, providing additional details specific to that job, including any suggestions if the job failed.




Table of Contents   |   << Previous Chapter   |   Next Chapter >>

Was this resource helpful in solving your issue?




NOTE: Please do not provide personal information.



Incorrect answer. Please try again: Please enter the words to the right: Please enter the numbers you hear:

Additional Comments (optional)