Upgrade notes
This topic contains important information for users who are upgrading from a previous QoreStor release.
- Existing QoreStor installations can not be upgraded to use Object Direct storage. To use QoreStor in Object Direct mode, you must perform a fresh installation.
- During the upgrade, the QoreStor installation script will verify that the Repository and Metadata filesystems are mounted with the noatime and dirsync mount options. If not, the installation script will prompt the user to allow the script to make the necessary changes in /etc/fstab and prompt you to reboot the system and re-run the QoreStor installation process.
NOTE: The above process does not occur when installing QoreStor in Demo mode.
- To ensure proper authentication of network shares, after upgrading to QoreStor 7.0, remove the QoreStor server from the domain and re-add it to the domain.
- QoreStor 7.0 contains support for VTL protocols. To enable VTL support, you must perform the following sequence of operations:
- Upgrade your existing installation to QoreStor 7.0. Do not select the option to install VTL support at this point.
- Using the steps documented in "Uninstalling QoreStor while maintaining configuration data" in the QoreStor Installation Guide, uninstall the newly updated QoreStor installation.
IMPORTANT: Uninstalling your existing QoreStor with the command below will preserve your data and application configurations.
/opt/qorestor/bin/qs_uninst
When running this command, you will receive the prompt:
To completely remove the application, user data, and configuration files, answer 'no' below,
and rerun the uninstaller with the '-a' option.
Do you wish to continue? yes\no [no]:
Enter Yes to continue without removing your data.
- Reinstall QoreStor 7.0 with VTL support by either using the --install-vtl option or answering “yes” to the prompt for adding VTL support.
- When using QoreStor with VTL, upgrades to the operating system of the QoreStor server require additional configuration. Refer to "Upgrading the QoreStor Operating System" in the QoreStor Installation Guide.
Upgrading QoreStor instances on Microsoft Azure
For QoreStor instances running on Microsoft Azure, perform the actions below before upgrading to 7.0.
- At the prompt, execute the following commands:
curl -o azureclient.rpm https://rhui-1.microsoft.com/pulp/repos/microsoft-azure-rhel7/rhui-azure-rhel7-2.2-74.noarch.rpm
sudo rpm -U azureclient.rpm
sudo yum clean all
Upgrading a migrated DR Series appliance to QoreStor 7.0.0.356
If you have previously migrated your DR Series system to QoreStor, you must upgrade your QoreStor software to build 6.1.0.814 before upgrading to this build (7.0.0.356). The upgrade process in build 6.1.0.814 includes a step that flushes WAM data, and that process must be completed before upgrading to 7.0.0.356.
Upgrading to Rapid CIFS Plug-in 4.0.3.3 with Secure Connect
Secure Connect is comprised of a set of client and server components that create a resilient and secure communication channel for use by WAN-connected clients. The server components are installed and enabled by default during the installation of the QoreStor server. Starting with the Rapid CIFS plug-in version 4.0.3.3, the plug-in installer includes the option to install and enable Secure Connect.
|
|
IMPORTANT: Refer to the Known Issues section of this document for Rapid CIFS issues known to be present at the time of release. |
If you have WAN-connected Rapid CIFS clients and choose to install Secure Connect, you can do so by following the steps below:
- On the media server, map a network share to your CIFS-enabled container.
- Download the plug-in installer from the website, as detailed previously.
- Open a command prompt with the “Run as Administrator” option selected. To do this using the Windows Start menu, click Start → All Programs → Accessories. Right-click Command Prompt and selectRun as Administrator.
This gives all the required privileges to install/copy the driver files to the Windows drivers folder.
- Run
QuestRapidCIFS-4.0.3317.0.exe. - When prompted, select Install a Secure Connection to install Secure Connect.
Secure Connect ensures backups to QoreStor are completed in spite of slow or unreliable WAN connections. When selecting this option, you will be prompted for additional configuration information required to make Secure Connect function correctly.
- At the Configure Secure Connect page, complete the dialog using the IP or fully qualified domain name (FQDN) of the QoreStor server and appropriate credentials.
The user account used must have the CIFS role assigned.
NOTE: The Configure Secure Connect operation is not supported for CIFS containers on DR Series appliances. DR Series appliances do not contain the required Secure Connect server component . This operation is available only for QoreStor instances. For CIFS containers on DR Series appliances, connect using the Rapid CIFS plug-in and the DR Series host name.
NOTE: The value entered in the Display Name field must not match the hostname of the QoreStor server.
Upgrading to Rapid NFS Plug-in 4.0.3.3
Secure Connect is comprised of a set of client and server components that create a resilient and secure communication channel for use by WAN-connected clients. The server components are installed and enabled by default during the installation of the QoreStor server. Starting with the Rapid NFS plug-in version 4.0.3.3, the plug-in installation script includes the option to install and enable Secure Connect.
|
|
IMPORTANT: Refer to the Known Issues section of this document for Rapid NFS issues known to be present at the time of release. |
If you have WAN-connected Rapid NFS clients and choose to install Secure Connect, you can do so by following the steps below:
- Download
QuestRapidNFS-4.0.3317.0-x86_64.bin.gzfrom the website. - Unzip the package.
unzip QuestRapidNFS-4.0.3317.0-x86_64.bin.gz - Assign execute bit to change the permission of the binary package:
chmod +x QuestRapidNFS-4.0.3317.0-x86_64.bin - Install the Rapid NFS package. Before installing, remove the stale NFS entry.
QuestRapidNFS-4.0.3317.0-x86_64.bin -install - Load the file system in user space (FUSE) module, if not already loaded:
modprobe fuse - Create a directory on the client. For example:
mkdir /mnt/backup - Mount Rapid NFS as a file system type using the mount command. For example:
mount -t rdnfs 10.0.0.1:/containers/backup/mnt/backupTo enable Secure Connect, mount Rapid NFS using the sc flag, as shown below:
mount -t rdnfs 10.0.0.1:/containers/backup/mnt/backup sc,user=backup_user,password=<backup_user password>
If you are using a DMA that supports a marker, set the marker by using -o in the mount command. For example, if you wanted to set the CommVault marker (cv):
mount -t rdnfs 10.0.0.1:/containers/backup /mnt/backup -o marker=cvNOTE: If you want to do a mount on AIX, you must set the nfs_use_reserved_ports and portcheck parameters first. The parameters cannot be set to 0. For example:
root@aixhost1 / # nfso -po portcheck=1 root@aixhost1 / # nfso -po nfs_use_reserved_ports=1
Resolved issues
The following is a list of issues addressed in this release.
Table 1: Resolved issues in build 7.0.0.356
| Issue ID | Resolved Issue |
|---|---|
| QS-6987 | Added the ability to disable the NFS server to customer environment variable |
| QS-7005 | Retrict the number of worked threads and network threads to max of 32 for AIX |
| QS-7078 | Error performing datastore IO |
| QS-7158 | GUI showing multiple entries for same events |
| QS-8003 | Restricted QSMenu access to only accounts with permissions |
| QS-8164 | secure connect and install issues on Veritas Backup Exec |
|
QS-8323 12345678 |
Hybrid replication not working |
Open issues
Known issues
The issues below are known to exist in this release.
| ID | Issue |
|---|---|
|
QS-437 QS-438 |
When using multiple NetVault Backup Servers to access the same QoreStor Server, use storage group, container, and user names unique to each NetVault Backup server to avoid accidental deletions. |
|
QS-627 12345678 |
After deleting a container and storage group, immediately creating a new container with the same name may fail. Workaround: This failure occurs because the old container is still in a delete_pending stage. To proceed with creating a new container, wait until the old container has been completely deleted via the QoreStor Cleaner run. |
|
QS-1420 |
When executing the QoreStor uninstallation script, the script will report and continue if illegal options are entered. |
|
QS-1446 |
If the QoreStor partition is not set to automount, and the QoreStor server is rebooted, the system appears to be operational but shows 0 physical capacity. |
| QS-1588 | When running Optimized Duplication jobs in Backup Exec, the container quota is not enforced as it is for backup jobs. |
| QS-1670 | For Linux clients, the full version number of RDA plug-ins is not displayed. |
|
QS-1823 |
In some situations, the deduplication savings for a storage group shows as 100% before a backup has occurred. Once a backup has occurred, the deduplication savings will be displayed accurately. |
|
QS-1980 |
When deleting a storage group, the Storage Group page will display timestamp data where the storage group entry used to appear. This occurs because the storage group is still in a delete_pending stage. Once the delete is completed and the UI refreshes, the timestamp will not longer appear. |
|
QS-2236 |
When installing QoreStor, if a required port is unavailable the installation will continue and be considered successful, yet QoreStor will start in Maintenance Mode. Workaround: Ensure that all required ports are available to QoreStor. |
|
QS-2242 |
When installing QoreStor, the filesystem selected for the QoreStor repository should not contain data from other application or users. QoreStor must have exclusive access to the repository filesystem. |
| QS-2604 |
If unregistered clients access QoreStor CIFS shares by mounting the share, the /var/log/messages will contain numerous host name/mismatch errors. Workaround: Unregistered clients need to be updated in DNS server manually. |
| QS-2694 |
When the system time on the QoreStor server is synchronized with the domain time, this may cause the system time to adjust backwards. If this occurs, system statistics (like read/write throughput statistics) will appear to be hung for an amount of time equal to the time adjustment. |
| QS-3779 |
When using Secure Connect with NetVault Backup in a multiple-machine configuration (NetVault server, NetVault client, QoreStor server), Secure Connect can respond to errors only for connections between the NetVault server and QoreStor or the NetVault client and QoreStor. Secure Connect does not address connections between the NetVault server and NetVault client. |
| QS-4169 |
When using the Linux exports http_proxy or https_proxy, no_proxy is also required for the watcher service to function correctly. Refer to "Accessing QoreStor" in the QoreStor User Guide. |
| QS-5105 | Changes to a Cloud Tier Policy for inclusions or exclusions will not take effect until the QoreStor service has been restarted. |
| QS-5438 | After performing a DR to QoreStor migration, network settings are reset to default. |
| QS-5627 | The current error output of "rda --limit" without any argument incorrect suggests limits are enforced via Mbps (megabits per second) when the limit is actually in MBps (megabytes per second). |
| QS-5629 |
When configuring a custom graph, if you select a period for which there is no data, the graph will be blank and display "No Data Available" |
| QS-5826 | When performing a DR to QoreStor migration, bonding modes and MTU settings are not |
| QS-5891 | Rapid CIFS is not supported on Windows Server 2016 with secure boot enabled. |
| QS-6291 |
When using the latest version of the Rapid CIFS plug-in with Veeam Backup and Recovery, the configurations below are required:
|
| QS-6653 |
OST MSI plugin reports a new version is already installed when installing an updated driver Workaround: Uninstall the OST driver before installing the newer driver |
| QS-6662 |
Replication add for AIR should fail if replication_traffic and encryption options used in the --add CLI. Both replication_traffic and encryption options are irrelevant to AIR and user should not be allowed to use them while adding AIR replication. Above parameters are restricted in --update CLI so similarly should be blocked in add CLI. |
| QS-6782 | When installing Rapid CIFS on Windows 2008 R2, the installation deploys driver version 4.0.3207.1 , causing the version displayed by rcifsctl.exe driver -q to be different from the version in the Windows Programs and Features dialog. The functionality of Secure Connect is not changed. |
| QS-6808 |
When configuring Backup Exec with CIFS shares using the display name, the steps below must be followed:
|
| QS-6860 | During upgrade, the SMB config file is overwritten. Any manual changes to this file will be lost on upgrade. |
| QS-7029 | When using Rapid NFS with Secure Connect, the NFS container must have insecure option set. This must be done via the command line. Refer to Upgrade notesfor more information. |
| QS-8945 |
When QoreStor is installed on Linux versions 7.3 - 7.7, configuring an archive tier may result in a memory leak. This is due to an issue with the curl package installed on those versions of Linux. Workaround Either upgrade the Linux version on the QoreStor server to 7.8, or update the curl package to curl 7.29.0-57.el7. DR Series systems migrated to QoreStor which are on Oracle Linux 7.3 should update the curl package to 7.29.0-57.el7 |
| QS-9056 |
On DR Series Systems migrated to QoreStor, the maximum inode limit for an object container is set to 1 million. In some cases, this may result in a "maximum allowable File(s) and Directories limit" error. Workaround: To increase that, the environmental variable MDS_OT_INODES_ALLOWED in /etc/oca/customer.env has to be set to a higher value. Please contact Quest Support for assistance making this change. |
| QS-9021 |
During object direct installation, if the message "Failed to validate object direct connection string! "may be received if the certificate has been changed or is expired on the QoreStor server. Workaround Purge the certificate with the command below cloud_tier --purge-ssl-certificate |
| QS-9109 | When creating user accounts with the Object role, the user name must be 3 or more characters long. |
| QS-9122 | For very small files (128 bytes or smaller) in an archive tier, the data is stored in AWS S3 itself. These files do not need to be restored from the Glacier archive. S3 HEAD operation returns ContentLength for a given object. If it is 128 or less, no restore operation is required. |
| QS-9177 | When configuring the Rapid NFS client with Secure Connect, You may mount the plug-in with either the IP address or the fully qualified domain name (FQDN). If you use the FQDN, you must also add an entry in the /etct/hosts file on the QoreStor system and verify that the hostname is resolvable. |
Product Licensing
QoreStor offers a backend capacity licensing model to allow for simple integration with other Quest Data Protection products.
- Standalone license - QoreStor is licensed by the amount of backend capacity required. Standalone licenses are available as either perpetual licenses (with no expiration), or term licenses, which expire after a specified period of time.
-
NOTE: Term licenses are intended for specific customer use cases, i.e., licensing according to yearly billing cycles. A perpetual license is appropriate for most customers.
QoreStor licenses are additive, meaning that if you purchase a 5TB license now, and a 10TB license in the future, you will have 15TB total capacity.
|
|
NOTE: Licenses for QoreStor are specific to the QoreStor server. When installing a license, the System ID for your QoreStor server is required. You can obtain the System ID with the command system --show | grep "System ID" |
Evaluating QoreStor
QoreStor offers two methods for evaluation:
- Default installation - If no license is installed, QoreStor defaults to a no-cost, 1TB capacity installation supported by the QoreStor Community. This option requires no license and does not expire.
- If a license is applied to a server running in this mode, the free 1TB is not added to the purchased license capacity.
- When installed in Demo mode, the capacity is limited to 100GB.
- Full capacity trial - available on the Quest Software Trial site, which provides a 30-day evaluation license for up to 360TB and access to Quest Support. After the evaluation period has expired, the QoreStor server will operate in Manual Intervention mode until a license is applied. To use QoreStor beyond that time frame, you will need to purchase a perpetual standalone license.
- If installed in Demo mode, the capacity is limited to 100GB
- If a longer trial period is required, please contact Quest Sales.
If you have purchased a standalone license, you can install it using the system --license command, as described in the QoreStor Command Line Reference Guide.
|
|
NOTE: When ordering a license, the System ID for your QoreStor server is required. You can obtain the System ID with the command system --show | grep "System ID" |