Configure Q-Cloud
The Q-Cloud tab on the Configuration > Storage Destinations page enables you to perform actions pertaining to Q-Cloud resources. The Q-Cloud page displays a table showing the Q-Cloud resources that have been registered/activated for use in StorNext.
- File retrieval from Q-Cloud Vault can take up to 5 hours.
- Retrieval requests to StorNext for files in Q-Cloud Vault are issued immediately, similar to other devices supported by Storage Manager.
- If an application requests multiple files (issues these requests one file at a time) and then waits for each retrieval to complete before issuing the next file to be retrieved, each file can take up to 5 hours. Since the requests are sequential (it waits for the previous retrieve to complete for two files), file retrieval can take up to 10 hours to complete. However, if the retrievals are submitted to StorNext concurrently, it can take up to 5 hours for two files to complete.
- While each file retrieval waits for completion (up to 5 hours), the retrieval process consumes and retains a certain amount of system resources for that length of time until completion.
Caution: A large number of file retrieval requests issued concurrently can severely impact system performance.
- The Partial File Retrieval feature is supported with Q-Cloud Archive targets, with the exception of configurations where client-side encryption or compression is used.
- The Partial File Retrieval feature is not supported with Q-Cloud Vault targets.
For additional information on Partial File Retrieval, see the StorNext Partial File Retrieval User’s Guide.
If the StorNext configuration has restricted network access because of firewall rules, the firewall configuration may need to be updated to use Q-Cloud.
- Open HTTPS access (port 443) to
s3‐us‐west‐2.amazonaws.com
(note, this is an example for the US-West-2 region). The appropriate region should be used in its place. - For access to the Q-Cloud Controller, open HTTPS access (port 443) to
api‐qcloud.quantum.com
. This allows you to configure and validate your Q-Cloud installation.
-
Locate the IP addresses for the appropriate AWS region in https://ip-ranges.amazonaws.com/ip-ranges.json. Allow access to these addresses. The list may change several times per week.
Note: Amazon rotates IP addresses through a range in order to provide access to the AWS S3 service. Each region of AWS has a specific set of IP ranges that are described at https://aws.amazon.com/blogs/aws/aws-ip-ranges-json/, and listed at https://ip-ranges.amazonaws.com/ip-ranges.json.
- Determine the IP address of
api‐qcloud.quantum.com
, and open HTTPS access to this address.
Alternatively, open all outgoing HTTPS traffic from the StorNext installation to the Internet.
Parameter/Button | Description |
---|---|
Media ID |
Displays the Media ID representing a purchased resource. It relates the Q-Cloud bucket to a StorNext media. |
Product Key |
Displays the Product Key associated with the StorNext media. |
Provider |
Displays the underlying storage provider. |
State |
Displays the operational state of the storage media. |
Max Streams |
The Max Streams value defines the number of concurrent I/O operations that can write concurrently. By default, the maximum number of streams is set to 48, or you can select a different value from the Max Streams drop-down list when you click Preferences.... See Configure a Media ID Preference. |
Copy Number |
Displays
the copy number assigned to the Q-Cloud media. |
Policy Class |
Displays the name of the policy. |
Evaluation Key |
Displays Yes or No. If Yes, the product key is an evaluation key. If No, the product key is not an evaluation key. |
Expiration Date |
Displays the expiration date of the selected product key. |
Overused |
This parameter applies to evaluation keys and indicates if you have exceeded the limits of the evaluation. For example, too much data stored in Q-Cloud. |
Region |
Displays the region the Q-Cloud media belongs to. |
File Count |
Displays the number of files currently stored on the media. |
Manage Keys... |
Click to display the Manage Keys page where you can add or remove additional Product Keys. For additional procedures, see Add a Product Key and Delete a Product Key below. |
Preferences... |
Click to configure your preferences for the currently selected product key. See Configure a Media ID Preference. |
Check Connectivity | Click to check the connectivity to the Q-Cloud media. If connectivity fails, contact Quantum Technical Support. |
Refresh |
Click to update the Q-Cloud page with current information. |
Select Action (Online) |
Select Online manually change the media state to online. |
Select Action (Offline) |
Select Offline to manually change the media state to offline. |
Select Action (Remove All Q-Cloud Storage) |
Select Remove All Q-Cloud Storage to purge and factory reset the system. Note: The option is only available if the Q-Cloud media do not contain files. |
On the Configurations > Storage Destinations > Q-Cloud page, click Manage Keys... to display the Manage Keys page.
For additional procedures, see Add a Product Key and Delete a Product Key below.
Parameter/Button | Description |
---|---|
Access ID |
Enter the customer access ID provided by Quantum. |
Product Keys |
Enter the customer product key provided by Quantum. |
Delete |
Click
to remove the selected Product
Key from the list. |
Add |
Click
to add a new Product Key
to the list after you enter it into the Product
Keys field. |
Apply |
Click to commit the edited list of Product Keys and/or Access ID. |
Reset |
Click to restore the current list. |
Cancel |
Click to cancel the editing session and return to the Q-Cloud page. |
-
In the Access ID field, enter the customer access ID provided to you by Quantum. Upon entering the Access ID once and successfully committing a configuration, the Access ID field remains populated when you return to the Manage Keys page.
-
In the Product Keys field (adjacent to the Add button), enter the customer product key provided to you by Quantum, select a Policy Class to assign the Q-Cloud media directly to it, and then click Add. The Product Keys list (above the field) displays the value just added. You must enter an Access ID in order to add Product Keys. Repeat this step to add additional product keys.
Note: If a Policy Class is not selected, the media is assigned to System Blank (in other words, the default blank pool).
-
Click Apply. The Product Key appears on the main Q-Cloud page. Upon clicking Apply, the actual process to commit the configuration is run as a background task. The GUI returns to the Q-Cloud page immediately if there are no locally detected errors. In some cases, the background process may require some time to execute and the Q-Cloud page will not immediately reflect your changes. As with other similar processes, navigate to the Reports > Jobs page to verify the outcome of the background task. In the case of a delayed success, click Refresh on the Q-Cloud page to display the current state of the system. In the case of a failure, the Q-Cloud page may not update; navigate to the Reports > Jobs page to determine the cause of the error.
-
(Optional) Click Reset to restore the current list.
-
(Optional) Click Cancel to cancel the editing session and return to the Q-Cloud page.
-
In the Access ID field, enter the customer access ID provided to you by Quantum.
-
In the Product Keys list, click a product key, and then click Delete to remove the selected product key from the Product Keys list. You must enter an Access ID in order to delete Product Keys. Repeat this step to delete additional product keys.
-
Click Apply. The Product Key is removed on the Q-Cloud page. Upon clicking Apply, the actual process to commit the configuration is run as a background task. The GUI returns to the Q-Cloud page immediately if there are no locally detected errors. In some cases, the background process may require some time to execute and the Q-Cloud page will not immediately reflect your changes. As with other similar processes, navigate to the Reports > Jobs page to verify the outcome of the background task. In the case of a delayed success, click Refresh on the Q-Cloud page to display the current state of the system. In the case of a failure, the Q-Cloud page may not update; navigate to the Reports > Jobs page to determine the cause of the error.
-
(Optional) Click Reset to restore the current list.
-
(Optional) Click Cancel to cancel the editing session and return to the Q-Cloud page.
- On the Configurations > Storage Destinations > Q-Cloud page, click a radio button to select a media ID you want to configure (corresponding to a media ID located under the Media ID column).
-
Click Preferences... to display the Preferences page. The table below provides a description for each parameter/button on the Preferences page.
Parameter/Button Description Product Key
Displays the product key corresponding to the Media ID you selected on the Q-Cloud page from Step 1.
Max Streams
The Max Streams value defines the number of concurrent I/O operations that can write concurrently. By default, the maximum number of streams is set to 48, or you can select a different value from the Max Streams drop-down list. Copy Number
Displays the copy number assigned to the Q-Cloud media. Select copy number 1, 2, 3, or 4 from the list if files do not exist on the media.
Update
Click to update your preferences for the currently selected Product Key.
Cancel
Click to cancel the editing session and return to the Q-Cloud page.
- In the Max Streams drop-down list, select the number of streams. For Copy Number, the only option available 1.
- Click Update to proceed and display the confirmation dialog requesting you confirm your preferences. Perform one of the following:
- Click Yes to confirm your selected preferences. A confirmation dialog appears; click OK. The Q-Cloud page is displayed with your updated preferences.
- Click No to disregard your selected preferences and return to previous page.
- (Optional) Click Cancel to cancel the editing session and return to the Q-Cloud page.
Follow the procedure below to replace your Q-Cloud Product Key. For example, if your Q-Cloud Product Key is compromised and you are reissued a new Product Key from Quantum.
- On the Configurations > Storage Destinations > Q-Cloud page, click a radio button to select a media ID you want to configure (corresponding to a media ID located under the Media ID column).
- Click Preferences... to display the Preferences page (see Configure a Media ID Preference).
- Note the Product Key corresponding the Media ID you selected in Step 1.
- Click Cancel to return to the Q-Cloud page.
- Click Manage Keys....
- In the Product Keys list, click the obsolete product key (from Step 3) and then click Delete.
- In the Product Keys field (adjacent to the Add button), enter the new product key provided to you by Quantum, and then click Add. The Product Keys list (above the field) displays the value just added.
-
Click Apply. The new Product Key appears on the Q-Cloud page.
Note: If you click Apply after deleting the obsolete product key (Step 6) without adding the new product key, you will receive a
putConfig
error message.
- On the Configuration menu, click Storage Policies.
- Click the radio button corresponding to the Q-Cloud policy class you want to enable encryption on, and then click Edit....
- Click the General tab.
-
Click the Encryption list, and then select Server AES256 S3.
- Click Apply to save your changes to the policy class.
- (Optional) Click Cancel to discard your changes and return to the Storage Manager Policies page.
Contact Quantum Technical Support for assistance with disaster recovery to and from Q-Cloud.