Manual Chapter : Licensing

Applies To:

Show Versions Show Versions

ARX

  • 6.3.0
Manual Chapter
11 
Use the clear active-license command to remove the active license from this system. This renders the current system unlicensed, so that you can no longer use its storage services or enter gbl mode in the CLI. Use the command only on the advice of F5 Support.
If the ARX can connect to the Internet, you can use the license activate command to automatically re-activate the license. Otherwise, you can use a manual activation method, as described in the documentation for the license create license-dossier command.
You can use the show active-license command to view the license-expiration time and all the currently-licensed features on the system.
stkbrgA# clear active-license
Use the license activate command to activate your software license and begin setting up storage services on the ARX.
base-reg-key base-key (1-33 characters) is the base registration key for the current ARX. If you purchased hardware with Release 6.00.000 or later, the key is installed before shipment; use the <tab> key to auto-complete your base registration key. To upgrade older hardware to Release 6.00.000 or later, contact your F5 Sales representative to purchase a license and receive the key in an E-mail message. For trial software, you can get a key for a trial license E-mailed to you from the same site where you downloaded the software, https://www.f5.com/trial/.
add-on-key add-key (1-15 characters) is a registration key for an add-on license. You can purchase an add-on license to add more capacity or additional features to your ARX. As above, contact your F5 Sales representative to purchase an add-on license and receive the key in an E-mail message.
Trial licenses, obtained from https://www.f5.com/trial/, and evaluation licenses have an expiration date built into them. The timer for the license expiration begins when you run the license activate command or manual activation (described below). If you are installing one of these temporary licenses on a redundant pair of ARX devices, the start dates should be no more than 24 hours apart. We recommend activating the license at both peers on the same day. This avoids a large gap in time where one peer is licensed and the other peer is unlicensed, and it also avoids an SNMP trap that warns you of the license mismatch.
This command contacts a license server at F5, http://activate.f5.com/, so the ARX must have a static route (ip route) to the Internet and access to a DNS server (ip name-server) before you use it. These network settings should be properly configured during installation, in the initial-boot script. You can use ping license-server to confirm that you have a usable connection to the server. If not, you can use the show ip route command for a list of static routes, and use show ip route monitor to check the status of each route. You can also use show ip domain to see your DNS setup, and/or ip name-server to add a new DNS server to the ARX configuration.
Then the CLI shows you a summary of these items; enter yes to accept the entries, or no to restart the list.
Use the show active-license command to see all of the licensed limits after you install the base license.
An add-on license changes the limits expressed in show active-license; the CLI informs you of all the changes after you run this command with the add-on-key option.
stkbrgA# license activate base-reg-key CRJGV-QPDYW-SATNK-RGBYY-DMTMOBL
Use the license activate file command to activate a valid license file, one that was downloaded from http://activate.f5.com/. You can also use it to activate a copy of the active.license file (which is created by the license activate command).
file-name (1-1024 characters) is the name of the license file to activate. For a full list of available license files, you can use the show license command.
You can use a faster method for activating your license if the ARX has a valid route to the license server at http://activate.f5.com/. The ping license-server command tests the connection between the ARX and the license server. If this ping command succeeds, you can use the license activate command instead of this one.
The license create license-dossier command creates a dossier file to identify the ARX and enumerate its capabilities. The file name is arx.dossier; you can use the show license-dossier command to confirm that it exists.
Use your preferred form of the copy command (such as copy ftp, copy scp, or copy smtp) to upload the arx.dossier file to a host that can connect to the Internet.
http://activate.f5.com/
At the ARX CLI, use copy source-url license arx.license to download the .license file from the remote host to the license directory on the ARX.
Use this command, license activate file arx.license, to activate this new license on the ARX. One or more information messages appear at the end indicating the final success or failure of your license activation.
Trial licenses, obtained from https://www.f5.com/trial/, and evaluation licenses have an expiration date built into them. The timer for the license expiration begins when you run the license activate command or this command. If you are installing one of these temporary licenses on a redundant pair of ARX devices, the start dates should be no more than 24 hours apart. We recommend activating the license at both peers on the same day. This avoids a large gap in time where one peer is licensed and the other peer is unlicensed, and it also avoids an SNMP trap that warns you of the license mismatch.
stkbrgA# license activate file arx.license
base-reg-key base-key (1-33 characters) is the base registration key for the current ARX. If you purchased hardware with Release 6.00.000 or later, the key is installed before shipment; use the <tab> key to auto-complete your base registration key. To upgrade older hardware to Release 6.00.000 or later, contact your F5 Sales representative to purchase a license and receive the key in an E-mail message. For trial software, you can get a key for a trial license E-mailed to you from the same site where you downloaded the software, https://www.f5.com/trial/.
add-on-key add-key (1-15 characters) is a registration key for an add-on license. You can purchase an add-on license to add more capacity or additional features to your ARX. As above, contact your F5 Sales representative to purchase an add-on license and receive the key in an E-mail message.
You can use a faster method for activating your license if the ARX has a valid route to the license server at http://activate.f5.com/. The ping license-server command tests the connection between the ARX and the license server. If this ping command succeeds, you can use the license activate command instead of this one.
Then use your preferred form of the copy command (such as copy ftp, copy scp, or copy smtp) to upload the arx.dossier file to a host that can connect to the Internet.
http://activate.f5.com/
At the ARX CLI, use copy source-url license arx.license to download the .license file from the remote host to the license directory on the ARX.
Use license activate file arx.license to activate this new license on the ARX.
stkbrgA# license create license-dossier base-reg-key CRJGV-QPDYW-SATNK-RGBYY-DMTMOBL
Use the ping license-server command to send a simple request to your license server. This verifies that you can connect to the license server and use the automatic license activate command.
base-reg-key base-key (1-33 characters) is the base registration key for the current ARX. If you purchased hardware with Release 6.00.000 or later, the key is installed before shipment; use the <tab> key to auto-complete your base registration key. To upgrade older hardware to Release 6.00.000 or later, contact your F5 Sales representative to purchase a license and receive the key in an E-mail message. For trial software, you can get a key for a trial license E-mailed to you from the same site where you downloaded the software, https://www.f5.com/trial/. This option is unnecessary after activation.
If the output shows an error instead of a timestamp, the license server is unreachable. The ARX must have a static route (ip route) to the Internet for this command to succeed. Use the show ip route command for a list of static routes, and use show ip route monitor to check the status of each route.
stkbrgA# ping license-server
Use the show active license command to display a complete list of all features and limits that are currently licensed on this ARX.
System License Information is information about the active license itself. Here are some key fields in the output:
Auth Vers. is for internal use only.
Usage indicates the intended usage for the license. This is also for internal use only.
Registration Key is the base registration key used for license activate and similar commands.
Licensed version identifies the software release that is licensed. This is a release number with an x.y.0 format. You are permitted to install any maintenance release off of the same base, such as x.y.1, x.y.2, and so on.
License Date is the date when the license was first activated with license activate, license activate file, or a GUI equivalent.
License Start is the earliest date when the license could be valid. This does not appear for a production license, which has no start or end date.
License End is the expiration date for the license. This field also does not appear for a production license.
Service Check Date is used for comparison to any software that is installed later. The date of a major release is included in its release file; if that date is earlier than the licenses service-check date (in this field), you are permitted to install the new release. Use the show releases command to get a list of all release files on the ARX, and use boot system to prepare the ARX to install the new release.
Platform ID identifies the ARX platform to which this license applies. The codes are Z100 for an ARX-VE, A106 for an ARX-500, D108 for an ARX-2000, D103 for an ARX-4000, C110 for an ARX-1500, or C111 for an ARX-2500.
Service Status is a string to explain the implications of the Service Check Date above.
Module List contains a sub table for each add-on license. Add-on licenses will be supported in a future release.
Feature List shows all of the features and limits that the active license supports.
Some of these features contain a suffix of _4k. This indicates that the values are shown in blocks of 4,096. Multiply each such value by 4096 to get the actual limit.
Use the license activate command to automatically activate the license for the current ARX. Automatic activation is only possible if the ARX has a network connection to the F5 web site, http://activate.f5.com/; if not, you can use the license create license-dossier command to start the process of manual activation.
bstnA# show active-license
bstnA# show active-license
A license dossier is a file that describes the ARX and its capabilities. The dossier file is used for license activation; the license server requires the ARX dossier to provide you with a license. The dossier is encrypted. When you activate your license manually, you can copy and paste the encrypted dossier into the form on http://activate.f5.com/. Use the show license-dossier command to display the dossier file as an encrypted string.
This command shows the encrypted string that represents your dossier file, if the file exists. You can copy this string from the CLI and paste it into the proper field at http://activate.f5.com/. As an alternative, you can use some form of the copy command (such as copy ftp, copy scp, or copy smtp) to copy the arx.dossier file to another host, and upload the dossier from that host to http://activate.f5.com/.
stkbrgA# show license-dossier
stkbrgA# show license-dossier
bb614ac893297bd563645a60e136d44952ad1990c831f65be13d88b5268ffec885a5ff45a13f8e25d1de0b60881e1c0e78a11ec840e7010f02a4d313ec243ba2961935b11d186a924d74188a1f635024f5010716d91f156e1278f4de6a8bcced12d4cbab70494df4b812e77737d25debb2c3f482c6f1b867cf44db73d316fe67ee09eef5fea1dc675e5caf665344ecfa9b36cd4bb0b1f9303b848a8c2d602971c1e864c181ec0c0d04579ad47aaf6da42e1d0b80afffe28622e5a2433555c8ca9dde13ab7fe7e6f9c81d4ceb583b7cc25e6f0798db29c41ef8a65eefa04854fbc12bff8f71f682f3fc94e09cb2bc24c70e47bf3391238225b5be7478fa59118c53a0ddd347b14e8ad0f69b7826a540969f8d2f2d79290c239d759151e2691dc72d78e33d7fda91a3271e9ca64a450f6359efd56267f658e1f2e36027b543d897bb61cebd4f129bec14040c58851eb837674469f0e101018c9ae035aa55d1682e9a1f30038da69142540cd7766c801d06ae24e8fe1e6456b7e492d724c68a9a8bb5909e8f3e2b22b8f9daae0f5607fc12629bdc32822ff85cf2d62133349338e24c66710cc83a1df88a4f99f754366ccb639938552fbe43fd82c3fc4f8515031c273297345017513837aaf4798950fef8a19ab001dd9543facd973bb02033ed0bf74ef919ac51db3b06af9dd0ad4a8c0c7cae49b2b3070f09fce06ce77fb687c359814cf304b57b2117262b90704ab206b7f768bbe601768851d722db6df07640fb4c4f8dda28f0c382d58a9e8f7b93d9f5cb18e16b12e31407e8e7b4b32d889aa6baea9f8447e9371c0ea5860511cc410427c9ebb46ade4c844767d7389f3f385bb9dd4495a5073618c966d90501fc791e293a7febf744969a5893bbc7bac7682fc00090d5ea954f4781d019ddf87d0e620d5583221b7e1564ac77e6c8c1a087abef548066c7a3ab7d96a3d022305f2f09c7fed78d0752384f60506a62f24fa9152523781aab5c5455db15334a4414825b89cf5e38d367471b85e5712acd409f56b587ddd4b223babee95de098ff6c1cc973e18521e405c664a0b4d3728fa5cbc050993bc25d5bcf30fd170ef1af8ab3f5941b1c97e7d4774b5e0b7ff18bf81bc20ce01090db42951734a576e721b9381ecf472f3fac3e7aa89c717e67f0198d4d7562d95d04f6d9d71c3804ddc0cbacaf3b2991cc5fcb0c3b3a86f61a771f8d57ceb8cec114be658a34b908b76549811aff4714e955966ec7cef0808a21f82c928393fc805ac6537e021f7de59c02978ff73aeaa2ab6f4bf313841ef84c1c1634b3406f27ce2d1d82133e0ccc2538fb7788b0c6410f32a944cc855f2345c4c683906d97e896c78a4efdca8ccf4ce7cae5dc94bafdf5ceff580732d6234da308abcd52c15b9a0d1766ae8dd6bd59dde0d5b5bac86b14a9ae8a2eb2a4019871a3695052b441a36cf777c01354b1e0176de064ad250dffd256cc48490a32ce99bea3876fce8eb01bd2b7bbbe4635fb6c23fc0611b835b01effe9758f2e163fe324628ec386e4dd8d257b12a05f5e2d4da3e298248df0b2bfa85c8ab12f8843d1ca4d7ff88354d1e64daf9f2deae7842e1812adebdc4a71fbe8addc5e1d051ba51793442740756aa51bc2e34e4ab8add498ff1eccb74a3184dbfaf9171ad6837ae2d2bc3e55b96e628179dc5146cc53a502279fb5d895b8634bdfdfe29a7332f0acf22688317d5c4a88cb806a6a4c18d0f896a8fe854aff4f3bc33b18f20ff0393c40001ec53a435aa570d61faa393332326a4337b64856829a951a3d2a53e3613b