NetSuite SuiteApps License Client Guide for Administrators

Through the NetSuite SuiteApps License Client, NetSuite can control access to features of certain SuiteApps depending on whether the account has an active license for the SuiteApp. The license client controls license usage through the following functions:

Note:

In Sandbox and Release Preview accounts, the NetSuite SuiteApps License Client always returns an active license to the requesting SuiteApp. This is to allow users to have access to the full functionality of SuiteApps when testing in Sandbox. In the License Test Mode page (Setup > License Client > License Test Mode), the License Test Mode field must be set to Active.

NetSuite SuiteApps License Client Features

The NetSuite SuiteApps License Client enables account administrators to do the following:

Installing the NetSuite SuiteApps License Client

To install the NetSuite SuiteApps License Client, use the following bundle information:

Upon installation, the NetSuite SuiteApps License automatically communicates with the NetSuite SuiteApps License Server to obtain license information.

You can view the License Dashboard to see the licenses retrieved for the account. See Viewing the License Dashboard.

Viewing the License Dashboard

To view the License Dashboard, go to Setup > License Client > License Dashboard.

If the list in the SuiteApps subtab is empty, it means that there was no license data retrieved for the account.

To request license data, see Requesting License Data from the NetSuite SuiteApps License Server.

Example

NetSuite SuiteApps License Client Guide for Administrators

Field

Description

Number of Client SuiteApps

Number of installed SuiteApps that are controlled by the NetSuite SuiteApps License Client.

Last License Refresh

Date and time of the most recent license cache data refresh.

Next Scheduled License Refresh

Expected date of license cache refresh.

TTL

Time to live.

Expressed in days, the TTL indicates the lifespan of the license cache data in the account.

The SuiteApps subtab displays the following columns:

Column

Description

SuiteApp

SuiteApps for which a license has been purchased from NetSuite.

Status

Indicates the status of the license data in the NetSuite SuiteApps License Client:

  • Active – The license cache data is active.

  • Stale – The SuiteApp does not have an existing active license.

  • Unknown – License cache data is corrupted.

Start Date

License validity start date.

End Date

License expiry date.

Requesting License Data from the NetSuite SuiteApps License Server

The NetSuite SuiteApps License Client has a scheduled script that runs daily to check if the license cache data is stale or not. If the license cache data is stale, the system will automatically request data from the NetSuite SuiteApps License Server.

You can manually request new license keys any time, even if the TTL of the license data is not yet expired.

To manually request license information, go to Setup > License Client > Manual License Request. The system redirects you to a page informing you that the license request is in progress.

Requests and responses are logged in the audit trail. See Viewing the Audit Trail of the NetSuite SuiteApps License Client.

Viewing the Audit Trail of the NetSuite SuiteApps License Client

To view the audit trail, go to Setup > License Client > Audit Trail.

The audit trail enables you to keep track of the communication between the NetSuite SuiteApps License Server and the NetSuite SuiteApps License Client, and the communication between SuiteApps and the NetSuite SuiteApps License Client.

The following communication activities are recorded in the audit trail:

NetSuite SuiteApps License Client Audit Trail Codes

The following table describes the audit trail codes and messages you may encounter:

Code

Type

Message

Description

CLIC006

Error

client.comm.LicenseRequester: No servers are registered to this account.

This error is thrown if the account does not have any servers registered. Server details should be included in the bundle.

CLIC010

Message

Resending license request to server (Retry {1}). Status: {2}

This message is being logged when the client is trying to resend the license request to the server after the initial failed request.

CLIC013

Message

Final license request attempt failed.

This message is being logged if the final attempt of the license retry functionality failed.

CLIC016

Error

client.comm.AuthRequester: No servers are registered to this account.

This error is thrown if the account does not have any servers registered. Server details should be included in the bundle.

General Notices