Post Installation License Management for UNIX

When you install NCache Java Client on your system, it is installed as an “Evaluation Copy” by default. You can use this evaluation copy for 60 days after which it expires and NCache Java Client stops working. You can either Activate NCache Java Client License (for a purchased copy) or Extend Evaluation Period (for a trial version).

Note

If you are using a purchased copy of NCache Java Client, we recommend you to activate its license right after installation in order to avoid inconvenience.

Activate NCache Java Client License

After you have purchased NCache Java Client licenses and installed NCache Java Client, you can activate your copy of NCache Java Client. Activating NCache Java Client saves you from the trouble of NCache Java Client expiration and you can use it for as long as you want. If you have internet connection on your machine, follow the Online Activation process to activate your license, otherwise, follow the process Manual Activation.

If your computer has Internet access, we suggest you to follow the simple and one-step Online Activation process.

Online Activation

Online activation is the fastest way to activate NCache Java Client but requires your machine to have Internet access. In order to activate your NCache Java Client copy through online activation:

In the UNIX terminal of your server machine, go to the location where you have installed NCache Java Client.

Navigate to the bin\activation folder to access the activate-cmd command line tool:

[root@servername]# cd ~/[InstallDir]/bin/activation

Run the activate-cmd tool as follows:

[root@servername]# ./activate-cmd -k key -f first-name -l last-name -e email [option[…]].

You get the following output on successful license activation: Thank you for registering your copy of NCache Java Client.

You can customize the license activation process through the following properties:

Switch/Properties	Purpose
`-k` (Required) `--licensekey`	Specifies the License key you received from Alachisoft
`-f` (Required)/`--firstname`	Specifies first name of the user
`-l` (Required)/`--lastname`	Specifies last name of the user
`-e` (Required)/`--email`	Specifies email address of user
`-m`/`--manual`	Enables manual mode
`-a`/`--authcode`	Specifies the Activation Authorization Code that you received in an email or generated through the Alachisoft website.
`-c`/`--company`	Specifies user’s company name
`-r`/`--address`	Specifies address of the user
`-t`/`--city`	Specifies city name of the user
`-s`/`-state`	Specifies state of the user
`-y`/`--country`	Specifies country of the user
`-z`/`--zip`	Specifies postal/zip code of the user
`-p`/`--phone`	Specifies phone number of the user
`-h`/`--help`	Displays a detailed help screen
`-G`/`--nologo`	Suppresses displaying the logo banner

Manual Activation

Manual Activation means you manually activate your copy of NCache Java Client through the following process:

In the UNIX terminal of your server machine, go to the location where you have installed NCache Java Client.

Navigate to the bin\activation folder to access the activate-cmd tool:

[root@servername]# cd ~/[InstallDir]/bin/activation

First generate an Activation Request Code through the command:

[root@servername]# ./activate-cmd -k key -f first-name -l last-name -e email -m

The output of this command is an encrypted text. This encrypted text is called Activation Request Code. You will use this code later to request an Activation Authorization Code which is required to activate NCache Java Client.

There are two ways to receive and Activation Authorization Code:
1. Send an Email to support@alachisoft.com to request an Activation Authorization Code. In your email, please copy the Activation Request Code you generated through the pervious step.
2. Generate Activation Authorization Code from Alachisoft Website (as explained later in the chapter).
Once you have the Activation Authorization Code, run the following command:

[root@servername]# ./activate-cmd –a activation-authorization-code

Your copy of NCache Java Client is successfully activated. You will get the following output on successful activation: Thank you for registering your copy of NCache Java Client.

You can customize the activation process through the following properties:

Switch/Properties	Purpose
`-a` (required)/`--authcode`	Specifies the Activation Authorization Code that you received in an email or generated through the Alachisoft website.
`-G`/`--nologo`	Suppresses displaying the logo banner
`-h`/`--help`	Displays a detailed help screen

Generate Activation Authorization Code from Alachisoft Website

An alternative to sending an email to receive the Activation Authorization Code is to directly generate an Activation Authorization Code from the Alachisoft website. This method is less time consuming than as it saves you from sending an email and waiting for a reply. Please follow these steps to get the Activation Authorization code:

Open the following URL: http://www.alachisoft.com/admin/customer_console/main.php
Enter the License Key and click Find and then click the Activate NCache link. NCache Java Client Email Activation page is displayed.
On the Email Activation page, enter the Activation Requested Code you generated through the –mflag in activate-cmd tool.
Click Verify.
The Activation Data Verification page appears.
Verify the information displayed on this page and click Activate! The next page that opens shows you the required Activation Authorization Key.
Once you have generated this key, please follow the steps described in Manual Activation to complete your registration process.

Extend Evaluation Period

When NCache Java Client expires, it is time for you to either purchase NCache Java Client licenses or if you need an extension to your evaluation period, you can obtain an “Extension Key” from Alachisoft Sales. Please send an email to sales@alachisoft.com (or to your account manager if you are in touch with him/her already) and ask for an extension key. You are provided with a 30-day extension key.

Once you have obtained the extension key, please follow the steps given below to extend your evaluation period:

Note

You can extend your trial version only 4 times; after that you will have to purchace NCache Java Client licenses in order to use NCache Java Client.

In the UNIX terminal of your server machine, go to the location where you have installed NCache Java Client.
Navigate to the bin\activation folder to access the extend-evaluation-cmd tool:

[root@servername]#cd ~/[InstallDir]/bin/activation

Run the extend-evaluation-cmd tool through the following command:

[root@servername]# ./extend-evaluation-cmd –e evaluation-key

You will see the following output message on successful extension of your evaluation period: NCache Java Client Evaluation period has been extended.

You can customize the evaluation extension process through the following properties:

Switch/Properties	Purpose
`-e /`--extensionkey` (required)	Specifies the evaluation extension key you received from Alachisoft
`-h` / `--help`	Displays a detailed help screen
`-G` / `--nologo`	Suppresses displaying the logo banner