Upgrading QoreStor
Upgrading your QoreStor software
This section is applicable to all QoreStor instances, including Virtual Machine instances (ESX and Hyper-V), AWS and Azure Marketplace instances, and DR Series migrated systems.
Depending on your environment and your comfort level with working in the Linux command line, you can upgrade using one of the following methods:
- The Linux shell - Through the Linux shell you can manually upload the binaries, verify and change file permissions, and run the installer with additional parameters. Refer to Upgrading your QoreStor software using Linux shell
- The QoreStor UI - In circumstances where access to the QoreStor server is restricted (or for those that choose not to upload the QoreStor binaries via the Linux shell), you may use the QoreStor UI to upload the QoreStor binary and signature files from your workstation. After uploading the files, you must run the upgrade from the Linux shell. Refer to Upgrading QoreStor Software using the QoreStor UI.
Both upgrade methods require that you download the new binaries from the Quest website and run them on the QoreStor server.
Prior to upgrading, review the best practices and recommendations in Before you upgrade.
Before you upgrade
Before upgrading your QoreStor instance, please review and follow the guidelines below:
- Make sure that all backup jobs which use the QoreStor server as a target are paused for the duration of the upgrade.
- Make sure that the QoreStor system has at least 3GB of free space on the root partition.
- When installing or upgrading the QoreStor on the systems running on RHEL 7.x, the repository for optional RPMs must be configured. Execute the following command before installing or upgrading the QoreStor:
subscription-manager repos --enable rhel-7-server-optional-rpms
- If the existing installation of QoreStor uses the default passwords for the UI admin login, qsservice user, or qsadmin user, then you must update these passwords before upgrading to QoreStor 7.4.1.
- To update the UI admin login password, run /opt/qorestor/bin/user --setpassword --name admin.
- To update the qsadmin user password, run passwd qsadmin.
- To update the qsservice user password, run passwd qsservice.
|
|
NOTE:
- When upgrading, if the installer discovers default passwords configured for any of the qsadmin, qsservice, or UI admin users, the installer exits and does not complete the installation.
- When upgrading, if the installer discovers any object containers in the ObjectStorageGroup, the installer exits and will not complete the installation. Object containers created before 7.2.0 release are no longer supported in QoreStor and must be removed before upgrade.
|
- There are some preliminary configuration steps that must be followed to prepare your DR Series for upgrade. Refer to Preparing your DR Series for migrationfor more information.
Downloading the QoreStor Software
You can download the executable for the new QoreStor software from the Quest Support Portal by completing the following steps.
To download the QoreStor software
- Log into the Quest Support Portal at https://support.quest.com/qorestor.
- In the Download Software section, click See All Downloads.
- Under the Platform Install section, find the row containing the appropriate version of QoreStor. Click Download.
- Select the appropriate QoreStor installer, and click either Download Now to download the software immediately, or Add to my Downloads.
- If you selected Add to my Downloads, click the My Downloads icon to view your download cart.
- Select the software to download and click Download Selected.
Upgrading your QoreStor software using Linux shell
To upgrade a current installation of QoreStor, complete the following steps.
To upgrade your QoreStor software using the Linux shell
- Download the new QoreStor executable. Refer to Downloading the QoreStor Software for detailed information.
- Using the appropriate utility (pscp on Windows / scp on Mac or Linux) copy the QoreStor installation files to the server.
NOTE: You may use the Upgrade page of the QoreStor to UI to upload binaries to the QoreStor server.
- Set execution permission on the installation files using chmod. For example,
$ chmod a+x qs_inst_7.4.1.169.bin
- With elevated privileges (either as root or with the sudo command), run the installation script according below
$ sudo ./qs_inst_7.4.1.169.bin
and follow the prompts to complete the upgrade.
- After the upgrade script completes, some QoreStor processes will continue behind the scenes. The system will not be operational until these processes complete. Run the command watch /opt/qorestor/bin/system —show to monitor the progress of QoreStor services.
|
|
NOTE: In some instances, some DMAs may experience timeout errors when trying to access QoreStor containers after an upgrade. If this occurs, wait until QoreStor is fully online, then restart the DMA. |
