Installing StorNext MDC Licenses from the Command Line for RPM-only Installations
For File System installations, or in instances where there is no available StorNext GUI, StorNext license keys for the system can be installed manually. This section describes how to install licenses from the command line in those situations.
Note: Licenses must be installed “by hand” on RPM-only installations because there is no GUI to lead you through the steps.
Before installing a license.dat file ensure that exactly one key is present in the file for each licensed feature, and that a Maintenance license key is present. The new license file must be complete before proceeding to the next steps. If you are updating a license file, ensure that old keys are removed so that they do not interfere with the updated license keys.
If you are installing a license file for HA MDCs, make sure that the keys for both MDCs are present in the license.dat file before proceeding.
Depending on the configuration of the system you are updating, you will use a different set of installation steps to install the license keys for StorNext and components for RPM installations from the command line. Here are the possible installation scenarios:
Installing StorNext License Keys on a Single-Node MDC
Installing StorNext License Keys on HA Systems (with a Shared File System)
Installing StorNext License Keys on a Failover System (without a Shared File System)
Installing StorNext License Keys on a Single-Node MDC
| 1. | From the command line of the MDC, type the following command: |
|
|
Caution: The command service cvfs stop will stop all StorNext services on the MDC.
| 2. | Navigate to the temporary location where you stored the new license.dat file. |
| 3. | Copy the license.dat file to the /usr/cvfs/config/ directory on the MDC. |
| 4. | Type the following command on the MDC: |
|
|
Installing StorNext License Keys on HA Systems (with a Shared File System)
Note: Stop the StorNext service on the secondary node of the HA system before stopping the StorNext service on the primary node.
| 1. | From the command line of the secondary node of an HA MDC (both File System and Storage Manager), type: |
|
|
Caution: The command service cvfs stop will stop all StorNext services on the MDC.
| 2. | From the command line of the primary node of an HA MDC, type: |
|
|
Caution: The command service cvfs stop will stop all StorNext services on the MDC.
| 3. | Navigate to the temporary location where you stored the new license.dat file. |
| 4. | Copy the license.dat file to the /usr/cvfs/config/ directory on the primary node of the MDC. |
Note: Start the StorNext service on the primary node of the HA system before starting the StorNext service on the secondary node.
| 5. | From the command line of the primary node of an HA MDC, type: |
|
|
| 6. | From the command line of the secondary node of an HA MDC, type: |
|
|
Note: Wait up to 2 minutes for the license.dat file to propagate to the secondary node of the MDC. After 2 minutes, display the file and verify the license has been propagated on the secondary node.
Installing StorNext License Keys on a Failover System (without a Shared File System)
Note: Stop the StorNext service on the secondary node of the HA system before stopping the StorNext service on the primary node.
| 1. | From the command line of the secondary node of an HA MDC, type: |
|
|
Caution: The command service cvfs stop will stop all StorNext services on the MDC.
| 2. | From the command line of the primary node of an HA MDC, type: |
|
|
Caution: The command service cvfs stop will stop all StorNext services on the MDC.
| 3. | Navigate to the temporary location where you stored the new license.dat file. |
| 4. | Copy the license.dat file to the /usr/cvfs/config/ directory on the primary node of the MDC. |
| 5. | Copy the license.dat file to the /usr/cvfs/config/ directory on the secondary node of the MDC. |
Note: Start the StorNext service on the primary node of the HA system before starting the StorNext service on the secondary node.
| 6. | From the command line of the primary node of an HA MDC, type: |
|
|
| 7. | From the command line of the secondary node of an HA MDC, type: |
|
|
Installing the StorNext FX License on Xsan MDCs
The StorNext FX license is installed on an Xsan MDC (metadata controller). To install the StorNext FX license on Xsan 3.0 and later MDCs:
Note: If you are upgrading from a previous version of StorNext FX, after the upgrade your StorNext FX license remains valid. There is no need to request a new license unless your system ID changes.
| 1. | Log on to the Apple Xsan MDC. |
| 2. | Obtain the CVFS ID from the Xsan MDC. |
Note: If you have more than one Xsan MDC, obtain CVFS ID outputs from each Xsan MDC.
From the command line, type:
|
|
| 3. | When you are prompted, type your user password. |
Output similar to the following displays:
|
|
| 4. | To obtain a permanent license, see Obtain and Install Perpetual StorNext Licenses for GUI-based Appliances and Customer-supplied MDCs. |
Note: You will need to provide the StorNext FX serial number and the cvfsid outputs obtained from the Xsan MDCs.
| 5. | From the command line change to the correct directory. Type: |
|
|
| 6. | Enter your user password. |
| 7. | Stop the volume(s) on the Xsan MDC. Type: |
|
|
Caution: The command stop <volume> will stop all StorNext services on the MDC.
Where <volume> is the name of the volume on the Xsan MDC.
Note: Repeat for all volumes you would like to mount on StorNext FX clients.
| 8. | Apply the license on the Xsan MDC. To apply the license, copy the license.dat file into the /Library/Preferences/Xsan/ directory on the Xsan MDC. The license.dat file can be found on the Metadata Controller at /usr/cvfs/config/license.dat for UNIX systems, and C:\Program Files\StorNext\config\license.dat for Windows systems. |
|
|
Where <volume> is the name of the volume on the Xsan MDC.
Note: Repeat for all volumes you would like to mount on StorNext FX clients.
| 9. | To display the list of volumes that are in use in this cluster, type: |
|
|
Note: The command select is executed at the cvadmin prompt.
Determining License Capacity
The numbers displayed on the StorNext License screen represent licensed capacity, not utilized capacity. You can determine the actual capacity for the File System, LAN Clients, Deduplication, Replication, Failover and Maintenance licenses by running the following command from the command line:
|
|
When running this command, do not use capital letters or include the angled brackets around the license type.
To obtain capacities for the Storage Manager, Vaulting, Storage Disk, Checksum, DDM and Maintenance features, run the following command from the command line:
|
|
Note that character after the dash in the preceding command is the letter L, not the numeral 1. As before, when running this command do not use capital letters or include the angled brackets around the feature name.
For more information, see the man pages for both of these commands.
