This section discusses the following:
See also “Upgrading Licenses” in Chapter 12.
This section discusses the following:
CXFS 7.0 and later requires CXFS 7.0 licenses.
CXFS licensing uses the SGI License Key (LK) software to implement a simple node-count scheme. (There is no restriction on the CPU count for either server-capable administration nodes or client-only nodes.)
All license keys are node-locked and installed only on the server-capable administration nodes. Each server-capable administration node should have equivalent keys installed.
You must purchase the following:
One CXFS_MDS license for each server-capable administration node.
One set of CXFS_CLIENT licenses equal to the number of client-only nodes in your cluster (see “CXFS_CLIENT License Bundles”). This entitles you to generate a set of CXFS_CLIENT keys for each licensed server-capable administration node.
You must install keys for the above on each server-capable administration node; all of the nodes should have equivalent keys installed.
 | Note: No license keys are installed on the client-only nodes. |
If you use an SGI UV 100, UV 1000, UV 2000, UV 300, UV 3000, or Altix ia64 system as a CXFS client-only node, you must also purchase the CXFS 7.x Feature Enabler for SGI NUMAlink systems. (These systems are not supported as CXFS server-capable administration nodes.) A single Feature Enabler is required per system and it does not generate an LK key. For a partitioned NUMAlink system, each partition requires a client license but only one Feature Enabler is required for the entire system.
The CXFS_CLIENT licenses determine how many client-only nodes can join the cluster. The following bundles are available:
1 client
5 clients
10 clients
20 clients
50 clients
These licenses are cumulative and can be used in any combination. However, some combinations are more cost-effective than others; larger client bundles have a lower per-client cost.
For more information about the appropriate licenses for your site, contact your SGI Sales representative.
Server-side licensing provides flexibility when changing the CXFS cluster configuration. For example, a 5-client license will allow any five client-only nodes to join the CXFS membership. For example, the cluster could have five Windows nodes on Monday and then change to four Mac OS X nodes and a Linux node on Tuesday.
To add a new server-capable administration node, you must purchase a new CXFS_MDS license for it and then generate a set of CXFS_CLIENT keys for it. You must install the CXFS_MDS and CXFS_CLIENT keys on the new node.
To increase the number of client-only nodes, you must purchase additional CXFS_CLIENT licenses; you do not have to change existing keys. The purchase of a new CXFS_CLIENT license entitles you to generate a key for it on each licensed server-capable administration node. You must install a key for this new CXFS_CLIENT license on each server-capable administration node in the cluster. See “ License Changes as a Cluster Grows”.
| Note: If the license capability is not uniform across the cluster and the active metadata server fails over to a server that has fewer CXFS_CLIENT keys installed, the client-only nodes that are currently in the cluster membership will remain in the membership. However, additional client-only nodes that attempt to join membership will fail until the membership count is reduced to below the license key entitlement on the active metadata server. |
This section discusses the following:
The following are the licenses needed for various example clusters:
A 13-node cluster with 12 client-only nodes and a single server-capable administration node:
One CXFS_MDS
One CXFS_CLIENT for 10 clients
Two CXFS_CLIENT for 1 client
A 14-node cluster with 12 client-only nodes and 2 server-capable administration nodes:
Two CXFS_MDS
One CXFS_CLIENT for 10 clients
Two CXFS_CLIENT for 1 client
A 3-node cluster with 1 client-only node and 2 server-capable administration nodes, where the client is an SGI UV 2000 with a single partition:
Two CXFS_MDS
One CXFS_CLIENT for 1 client
One CXFS 7.x Feature Enabler for SGI NUMAlink systems
A 6-node cluster with 4 client-only nodes and 2 server-capable administration nodes, where the client-only nodes are 4 partitions within a single SGI UV 2000:
Two CXFS_MDS
Four CXFS_CLIENT for 1 client
One CXFS 7.x Feature Enabler for SGI NUMAlink systems
A 14-node cluster with 12 client-only nodes, 2 server-capable administration nodes, and GRIO V2 support:
Two CXFS_MDS
One CXFS_CLIENT for 10 clients
Two CXFS_CLIENT for 1 client
One GRIO2_CLUSTER license
The following figures illustrate the license changes required as a cluster grows from 4 to 6 client-only nodes. Figure 5-1 shows that there is one CXFS_CLIENT license that is not being used by the current configuration. .
Figure 5-2 shows that a fifth client-only node can be added without any change in the CXFS_CLIENT licenses (which are now maximized). It also shows that the licenses can apply to client-only nodes running any supported OS.
Figure 5-3 shows that a new CXFS_CLIENT license must be purchased and a key installed on each server-capable administration node.
When you order CXFS, you will receive an entitlement ID for the licenses you purchased (one entitlement ID for each CXFS_MDS , each CXFS_CLIENT bundle, and each GRIO2_CLUSTER license; the CXFS_CLIENT and GRIO2_CLUSTER entitlements can generate multiple keys, one set per CXFS_MDS license). You must submit the system host ID, host name, and entitlement IDs when requesting your permanent CXFS license keys.
This section discusses the following:
To obtain the host information for a server-capable administration node, execute the following command:
/usr/sbin/lk_hostid |
For example, the following shows that the serial number is 000423d5fd92 and the license ID is 23d5fd92:
server-admin# lk_hostid 000423d5fd92 23d5fd92 socket=1 core=2 processor=2 #----------------------------------------------------------------------------- #The above is the default selected by lk_hostid. See below for additional #hostid pairs. #----------------------------------------------------------------------------- #Interface SN LI Driver ( Comment ) #----------------------------------------------------------------------------- eth0 000423d5fd92 23d5fd92 e1000 eth1 000423d5fd93 23d5fd93 e1000 |
To obtain your CXFS license keys, see information provided in your customer letter and the following web page:
http://www.sgi.com/support/licensing
If you do not have access to the web, please contact your local Customer Support Center.
This section discusses the following:
See also “License Key Error” in Chapter 15.
You can use the lk_verify -A command to verify LK licenses. To see more output, use the -v option. For example:
serveradmin# lk_verify -A -VVV
LK(License Keys) - Version SGI_SFS_2.3 2.2.0- Built Jan 12 2012 23:00:28-Vendor SGI- Silicon Graphics International
1 /etc/lk/keys.dat:187 product=CXFS_CLIENT, version=7.000, count=0, begDate=1355516270, \
expDate=1363323599, licenseID=201e9247, key=bLEHGcIya4N5icWKeLOQyFBjM7jT66Ci, \
info='CXFS CLIENT 1 NODE',attr='1', vendor='Silicon Graphics International', \
ref_id='267783'
Verdict: SUCCESS.
2 /etc/lk/keys.dat:192 product=CXFS_CLIENT, version=7.000, count=0, begDate=1355516339, \
expDate=1363323599, licenseID=201e9247, key=OSgtcSMJfQFN7LpQbavxz4Sm3BXx+ieK, \
info='CXFS CLIENT 5 NODE',attr='5', vendor='Silicon Graphics International', \
ref_id='267784'
Verdict: SUCCESS.
3 /etc/lk/keys.dat:197 product=CXFS_CLIENT, version=7.000, count=0, begDate=1355516393, \
expDate=1363323599, licenseID=201e9247, key=cqBOStuzITV85TwdhrgAOH4fPu0US9j/, \
info='CXFS CLIENT 10 NODE',attr='10', \
vendor='Silicon Graphics International',ref_id='267785'
Verdict: SUCCESS.
4 /etc/lk/keys.dat:202 product=CXFS_CLIENT, version=7.000, count=0, begDate=1355516454, \
expDate=1363323599, licenseID=201e9247, key=w3AYBzkqvQXj9VnMK2GUZ5otkgNoOy81, \
info='CXFS CLIENT 20 NODE',attr='20', \
vendor='Silicon Graphics International',ref_id='267786'
Verdict: SUCCESS.
5 /etc/lk/keys.dat:218 product=CXFS_MDS, version=7.000, count=0, begDate=1355770754, \
expDate=1363582799, licenseID=201e9247, key=PShg1XGVwu+d6YAx0RyN/FzLx6LwWoli, \
info='CXFS 7.0 MDS', vendor='Silicon Graphics International',ref_id='268052'
Verdict: SUCCESS. |
To verify that the license keys have been installed properly, use the cxfslicense -d command after installing the CXFS software (see Chapter 7, “Server-Capable Administration Node Installation”). Licensing errors will be reported to the fs2d log.
This section contains sample output:
The following output shows that the licenses are correctly in place:
serveradmin# cxfslicense -d License(s) found: 1 Found CXFS 7.0 MDS version 7.0 license for CXFS_MDS serial 268052 Server-side licensing is available License(s) found: 4 Found license for 1 of CXFS_CLIENT 7.0 serial = 267783. Found license for 5 of CXFS_CLIENT 7.0 serial = 267784. Found license for 10 of CXFS_CLIENT 7.0 serial = 267785. Found license for 20 of CXFS_CLIENT 7.0 serial = 267786. |
The following output shows that there is no metadata server license, and therefore the client licenses that are installed are ignored:
serveradmin# cxfslicense -d Cannot find valid version 7.0 LK license for CXFS_MDS No CXFS server-side license, any server-side client licenses will be ignored. License(s) found: 4 Found license for 1 of CXFS_CLIENT 7.0 serial = 267783. Found license for 5 of CXFS_CLIENT 7.0 serial = 267784. Found license for 10 of CXFS_CLIENT 7.0 serial = 267785. Found license for 20 of CXFS_CLIENT 7.0 serial = 267786. Error: No valid CXFS licenses found for this server. |
The following output shows that the metadata server license was found, but there are no client licenses:
serveradmin# cxfslicense -d License(s) found: 1 Found CXFS 7.0 MDS version 7.0 license for CXFS_MDS serial 268052 Server-side licensing is available No licenses available for CXFS_CLIENT 7.0 No client licenses for server-side licensing are available, CXFS clients will need a client-side license. |
The following output shows that no licenses were found:
serveradmin# cxfslicense -d Cannot find valid version 7.0 LK license for CXFS_MDS No CXFS server-side license, any server-side client licenses will be ignored. No licenses available for CXFS_CLIENT 7.0 Error: No valid CXFS licenses found for this server. |
You can use the cxfs_admin command to display license information after installing the CXFS software (see Chapter 7, “Server-Capable Administration Node Installation”). For example, the following is output from the show licenses command for the clusterOne cluster:
serveradmin# cxfs_admin -i cluster1 -c "show licenses"
Connecting to the CXFS server for the "cluster1" cluster...
Event at [ Mar 05 11:59:25 ]
status:licenses:
cxfs_client:
allocated=1
valid=36 |
For example, the following is truncated output from the status command for the cluster1 cluster:
serveradmin# cxfs_admin -i cluster1 -c status Connecting to the CXFS server for the "cluster1" cluster... Event at [ Mar 05 11:56:32 ] Cluster : cluster1 Tiebreaker : Client Licenses : allocated 1 of 36 ... |
Also see: