# License Information

During installation, the installation program generates the `install/OS/bin/kv.lic` file, where `install` is the directory in which you installed KeyView, and `OS` is the operating system. This file is opened and validated when the KeyView API is used.

TIP: Where the API allows, Micro Focus recommends that you provide the license by using the API (`fpInitWithLicenseData()`), rather than using the license file.

The license key controls whether the following are enabled:

- the full version of the KeyView SDK

- the trial version of the KeyView SDK

- language detection and advanced document readers—The following components are considered advanced features, and are licensed separately:

  - Microsoft Outlook Personal Folders (PST) readers (`pstsr`, `pstnsr`, and `pstxsr`)

  - Lotus Notes database (NSF) reader (`nsfsr`)

  - Mailbox (MBX) reader (`mbxsr`)

  - Character set detection library (`kvlangdetect`)

If you change the license key at any time, you must update the licensing information. See Update License Information.

## Enable Advanced Document Readers

To enable advanced readers in one of the KeyView SDKs, you must obtain an appropriate license key from Micro Focus and update the installed license key with the new information as described in Update License Information.

If you are enabling the MBX reader in an existing installation of Viewing SDK, in addition to updating the license key, you must also follow these steps:

If you are using the registry file:

1. Open the `install.reg.txt```in a text editor. The file is installed in the `install\redist` directory, where `install` is the directory in which you installed Viewing SDK.
2. Under the key `[HKEY_LOCAL_MACHINE\Software\Verity\Viewing SDK\KVMAILVE]`, change the parameter `"208="emlsr.dll"` to `"208="mbxsr.dll"`.
3. Save the file as `install.reg` and import the file into your Windows system registry.

If you are using the `kvsdk.ini` file:

1. Open the `kvsdk.ini` file with a text editor. The file is installed in the root of the Windows directory.
2. In the `[KVMAILVE]` section of the `kvsdk.ini` file, change the parameter `208=emlsr.dll` to `208=mbxsr.dll`.

## Update License Information

If you currently have an evaluation version of KeyView and have purchased a full version of the SDK, or you are adding a document reader (for example, the PST reader), you must update the license information that was installed with the original version of the KeyView SDK.

If you installed a full version of KeyView, but did not enter licensing information at the time of installation, you must also update the license information.

To update the information, do one of the following:

- Pass the new license information to `fpInitWithLicenseData()`.

- Manually update the license information that is stored in the text file named `kv.lic`.

- Re-install the product and enter the new license information when prompted.

Where possible, Micro Focus recommends that you update the license information by using the API. This method allows you to update your license without including a license file in the software that you distribute. This method is available for the C APIs in the Filter SDK, HTML Export SDK, and XML Export SDK.

Alternatively, you can create a license file and include it in the bin folder with the KeyView DLLs. This file must be called `kv.lic`, and must have your organization name on the first line, and your license key on the second line, with no white-space surrounding either.

To update the license information in the API

- Pass the new license information to `fpInitWithLicenseData()`.

To update the kv.lic

1. Open the license key file, `kv.lic`, in a text editor. The file is in the `install\OS\bin` directory, where `install` is the directory in which you installed KeyView, and `OS` is the operating system. The file contains the following text:

       COMPANY NAME
       XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX

2. Replace the text `COMPANY NAME` with the company name that appears at the top of the License Key Sheet provided by Micro Focus. Enter the text exactly as it appears in the document.
3. Replace the characters `XXXXXX-XXXXXXX-XXXXXXX-XXXXXXX` with the appropriate license key from the License Key Sheet provided by Micro Focus. The license key is listed in the Key column in the Standalone Products table. The key is a string that contains 31 characters, for example, `2TQD22D-2M6FV66-2KPF23S-2GEM5AB`. Enter the characters exactly as they appear in the document, including the dashes, but do not include a leading or trailing space.

4. The finished `kv.lic` file looks similar to the following:

       Autonomy
       24QD22D-2M6FV66-2KPF23S-2G8M59B

5. Save the `kv.lic` file.

© Copyright 2016-2020 Micro Focus or one of its affiliates | Send documentation feedback Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a mail client, and then send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm