Upgrading K2BTools licenses

Introduction

When a new major version of K2BTools is released, licenses must be updated to gain access to the newer version. This document presents a procedure that can be used to perform this update in a safe manner. The procedure differs depending on where the licenses are stored (either in each developer's local computer or on a Protection Server).

Notes:

  1. K2BTools licenses for a certain major version allow access to all prior versions. For example, if a K2BTools 8.0 license is installed, access is granted to all versions prior to that one (7.0, 7.1, 5.0, etc).
  2. K2BTools free edition licenses do not change when upgrading a K2BTools version.

Procedure

Before performing these steps the target K2BTools version must be installed. In the examples below, the target version is 8.0.

Step 0 - Only in GeneXus Protection Server

Add K2BTools versions to the Protection Server as described in Protection Server K2BTools setup.

Step 1 - Request temporary licenses for the new version

1.1 - Open K2BTools (local) License Manager or the Protection Server License Manager

If using the K2BTools (local) License Manager: Open GeneXus, go to K2BTools’ menu and execute the “Authorize K2BTools” action.

OpeningK2BToolsLicenseManager
"Authorize K2BTools" action

1.2 - Request temporary licenses for the target version

In this step, licenses for 60 days will be requested.

K2BToolsLicenseManager
K2BTools license manager

To do this, select the target version in the License Manager dialog, and click on the "Authorize" option. Then, select the "Authorize Online" option and enter the amount of days for the license (60 days).

Note: This request may be done via the "Generate Authorization File" option. In this case the amount of days should be specified in the rquest email.

1.3 - Install new licenses

When licenses arrive install them in your computer. From this moment on, the new K2BTools version may be used.

Step 2 - Uninstall licenses for old versions

2.1 - Open K2BTools (local) License Manager or the Protection Server License Manager

If using the K2BTools (local) License Manager: Open the legacy license manager located in Packages\K2BTools in the file OldLicenses.zip

K2BToolsLicenseManagerLegacy
K2BTools legacy license manager

2.2 - Select the old license and uninstall it

After uninstalling the version, a dialog like the one shown below will be shown. Note that a file is generated as a proof of the operation, please send the file in an email to the address claves@k2b.com

UninstallDialog
License Uninstalled Dialog

Step 3 - Request unrestricted licenses for the target version

To do this, follow the same steps as in the first step, but selecting "Unlimited" licenses. If the request is done via the web interface, select "Change Restrictions".

Common errors

1 - When uninstalling the license the following error is shown

LicenseManagerError
License is being used error

If this error is shown, the licenses are being used by an active GeneXus instance. Close all GeneXus instances and execute the process again.