K7727: License activation may be required before a software upgrade for the BIG-IP or

Enterprise Manager system

Non-Diagnostic

Original Publication Date: Aug 4, 2007

Update Date: Jul 18, 2018

Topic

This article applies to BIG-IP and Enterprise Manager systems. For information about other systems, refer
to the following articles:

K15365: License activation may be required prior to software upgrade for the BIG-IQ system
K20221362: License activation may be required before a software upgrade for the F5 iWorkflow
system

For license verification, the BIG-IP and Enterprise Manager systems verify the license check date in the
software against the service check date in the license file. The process is defined below:

Service Check Date

The service check date is located in the BIG-IP license and is the same as the date the license was last
activated or the date the service contract for the device expires, whichever date is earlier. For example, if
you have an active service contract that ends on December 31, and you license a device on June 30, the
service check date is set to June 30.

Note: The service check date in the BIG-IP license is updated each time the license is reactivated, if there is
an active service contract for this BIG-IP system.

License Check Date

The license check date is a static date built into the software for BIG-IP and Enterprise Manager systems.
The following table contains the license check date for each version.

License Check Date

Product Version
(yyyy/mm/dd)
BIG-IP 13.1.0 2017-09-12
BIG-IP 13.0.0 - 13.0.1 2017-01-13
BIG-IP 12.1.0 - 12.1.3 2016-03-18
BIG-IP 12.0.0 2015-08-03
BIG-IP 11.6.0 - 11.6.3 2014-08-05
BIG-IP 11.5.0 - 11.5.7 2013-12-05
BIG-IP 11.4.0 - 11.4.1 2013-04-23
BIG-IP 11.3.0 2012-10-25
BIG-IP 11.2.1 2012-08-20
BIG-IP 11.2.0 2012-04-25
BIG-IP 11.1.0 2011-11-01
BIG-IP 11.0.0 2011-07-11
BIG-IP 10.2.2 - 10.2.4 2010-10-01
BIG-IP 10.2.1 2010-06-05
BIG-IP 10.1.0 - 10.2.0 2009-11-24
BIG-IP 10.0.1 2009-04-24
BIG-IP 10.0.0 2009-01-12
BIG-IP 9.6.0 - 9.6.1 2007-12-05
BIG-IP 9.4.8 2009-05-27
BIG-IP 9.4.6 - 9.4.7 2008-09-15
BIG-IP 9.4.5 2008-05-01
BIG-IP 9.4.4 2007-12-07
BIG-IP 9.4.2 - 9.4.3 2007-09-18
BIG-IP 9.4.0 - 9.4.1 2006-10-02
BIG-IP 9.3.1 2007-10-09
BIG-IP 9.3.0 2007-03-23
BIG-IP 9.2.0 - 9.2.5 2005-08-24
Enterprise Manager 3.1.0 - 3.1.1 2012-08-20
Enterprise Manager 3.0.0 2012-04-25
Enterprise Manager 2.0.0 - 2.3.0 2009-11-16
Enterprise Manager 1.8.0 2006-10-02
Enterprise Manager 1.7.0 2006-08-18
Enterprise Manager 1.6.0 2006-08-18
Enterprise Manager 1.4.0 - 1.4.1 2006-08-18
Enterprise Manager 1.2.1 - 1.2.2 2006-08-18
Enterprise Manager 1.2.1 2006-10-02
Enterprise Manager 1.2.0 2005-08-24

Note: The License Check Date, as shown previously, and the Licensed Date, as seen in the bigip.license
file, are not the same fields. The Licensed Date is the first date that you used your Registration Key to
license your BIG-IP system. The only time you would see an update to the Licensed Date field would be
after an Allow-Move procedure, which allows a relicensing of your BIG-IP system using your original
Registration Key.

Enforcement during an upgrade

When you perform the software installation to upgrade the BIG-IP system, the installation process does not
validate the service check date with the license check date of the version being installed. If the service
check date is missing or is earlier than the license check date, the system will fail to load the configuration
when you attempt to boot into the upgraded software slot.

Enforcement during system startup

The license check date enforcement is applied during system startup. The system compares the license
check date to the service check date in the license file. If the service check date is earlier than the license
check date, the system initializes, but does not load the configuration. To allow the configuration to load,
you must update the service check date in the license file by reactivating the  system's license.

Important: For devices managed with Enterprise Manager 1.4.0 and later, the Enterprise Manager verifies
the license check date and the service check date before upgrading a managed system. If required, the
Enterprise Manager attempts to reactivate the BIG-IP system's license before performing the upgrade.

Preventing and recovering from license-related upgrade issues

You can prevent upgrade issues by relicensing your system before you perform the upgrade, or recover a
system that fails to initialize by relicensing your system after you perform the upgrade.

For example, if license enforcement fails during the upgrade, the configuration may fail to load when booting
to the new volume. When this occurs, the Configuration utility may display an error message that appears
similar to the following example:

The configuration has not yet loaded. If this message persists, it may indicate a configuration problem.

To mitigate license-related upgrade issues, complete the following procedures:

Verifying the service check date in your license

Reactivating the system license

Verifying the service check date of your license

Impact of procedure: Performing the following procedure should not have a negative impact on your system.

1. Log in to the command line.

2. To change directories to the /config directory, type the following command:

cd /config

3. To parse the bigip.license file for the Service check date, type the following command:

grep "Service check date" bigip.license

The output appears similar to the following example:

Service check date : 20151008

Note: The date format is year-month-day, so this example output is October 8, 2015.
 4. Reference the License Check Date table listed previously in this article, and verify that the service
check date from step 3 is a later date than the license check date listed for the version to which you
are upgrading. For example, to upgrade to BIG-IP 12.0.0, your service check date should be
20150803 (August 3, 2015) or later.

If the service check date in your bigip.license file is earlier than the license check date for the software
version you are attempting to install, you must reactivate the system's license before upgrading.

Reactivating the system license

Impact of procedure: The license reactivation process may reload the configuration and temporarily interrupt
traffic processing.

Note: Be sure to log in as the admin user to relicense the system. For more information, refer to K9965: The
admin user account must be used to license the system.

1. Log in to the Configuration utility.

2. Navigate to System > License > Reactivate.
3. Select either Automatic or Manual as the activation method.

Note: If your system does not have Internet access to the F5 license server, you must select Manual.

4. Click Next and follow the on-screen instructions. For more information about automatic or manual
license activation, refer to K7752: Licensing the BIG-IP system.

Note: To activate and install a license from the command line, refer to K2595: Activating and installing a
license file from the command line.

Supplemental Information

None