CLICENSE
You can use clicense to add, remove, query,
and maintain license information for
MetaFrame XP servers within a server farm. For more
information about
MetaFrame XP licensing, see "Licensing MetaFrame XP"
on page 137.
Syntax
clicense [add serial_number]
clicense [remove license_string]
clicense [force_remove license_string]
clicense [activate license_string
activation_code]
clicense [assign license_set_id server_name
number_to_assign]
clicense [strings]
clicense [products]
clicense [connections]
clicense [servers_using license_set_id]
clicense [in_use_by server_name]
clicense [in_set license_set_id]
clicense [sets_in license_string]
clicense [assigned_to server_name]
clicense [servers_assigned license_set_id]
clicense [available_for_assignment license_set_id]
clicense [read_db [file_name]]
clicense [refresh]
clicense [help option]
Parameters
activation_code
The license activation code. This is obtained from
the Citrix Product
Activation System
(http://www.citrix.com/activate).
file_name
The name of the licensing database
file.
option
The name of a clicense option.
334 MetaFrame XP Server Administrator’s
Guide
license_string
The license number. A license number consists of
seven groups of five
characters each: xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx. Each license
number has an associated serial number which
consists of five groups of five
characters each: xxxxx-xxxxx-xxxxx-xxxxx-xxxxx.
license_set_id
The license set ID
number.
number_to_assign
The number of license counts to assign to a
specified server.
serial_number
The license serial number. This number is located on
the software packaging.
See license_string.
server_name
The name or IP address of a MetaFrame XP server. Use
a period (.) to specify
the local server.
Options
add serial_number
Use to add serial numbers to the license store. This
returns the added license
string.
remove license_string
Use to remove a license string from the license
store, provided it does not have
active assignments.
force_remove license_string
Use to force the removal of a license string from
the license store. Active
assignments are dropped.
activate license_string
activation_code
Activates a license string in the license
store.
assign license_set_id server_name
number_to_assign
Assigns licenses from the specified license set to
the specified MetaFrame XP
server. To specify the local server, enter a period
(.).
strings
Retrieves a list of all installed license
strings.
products
Retrieves a list of all the installed product
licenses.
connections
Retrieves a list of all installed connection
licenses.
Appendix A MetaFrame XP Commands
335
servers_using license_set_id
Retrieves a list of all servers that are using a
license from the specified license
set.
in_use_by server_name
Queries and returns the license sets currently in
use by the specified server.
in_set license_set_id
Returns a list of all strings that contribute
licenses to a set.
sets_in license_string
Returns a list of all license sets to which a string
contributes.
assigned_to server_name
Returns the license sets that are assigned to the
specified server.
servers_assigned license_set_id
Returns the servers to which the specified license
set is assigned.
available_for_assignment license_set_id
Returns the number of activated licenses in a
license set that can be assigned.
read_db [file_name]
Reads license database configuration files into the
license store. If a file name
is specified, only files whose names begin with the
specified file name are
read into the license
store.
refresh
Refreshes all licensing
data.
help option
Provides additional information about the specified
option.
|
