Chat now with support
Chat with Support

QoreStor 7.1.0 - Installation Guide

Installing QoreStor with Object Direct Storage

Installing QoreStor in Object Direct configuration utilizes a volume layout different from a standard installation and the installation script requires additional cloud-configuration information. Before installing QoreStor, refer to QoreStor installation modesQoreStor installation modesand the QoreStor Interoperability Guide for additional information.

To install QoreStor in Object Direct mode

  1. Copy the QoreStor installation files to the server.
  2. Set execution permission on the installation files using chmod. For example,

    $ chmod a+x qs_inst_7.1.0.245.bin

  3. With elevated privileges (either as root or with the sudo command), run the installation script with the desired parameters, using the below information as a guide. To install QoreStor in object direct mode, use the --object-direct parameter.
  • qs_inst_7.1.0.245.bin -- -f –p <repository_path> -m <metadata_path> --object-direct --mode=<cloud-optimized|standard|large> --accept-eula --install-deps -e <cloud-provider> -t <cloud-container-name> -o <cloud-connection-string>

Where.

-f enables firewall configuration
-h, --help displays this help message
-p, --repository_path=<pathname> is the path to the repository storage
-m, --metadata_path=<pathname> is the path to the metadata storage
--accept-eula accepts the EULA agreement
--install-deps resolves missing package dependencies
--fix-mount-opts adds any required mount options to fstab entries
--object-direct installs support for object-direct storage
--no-object-direct does not install support for object-direct storage
-e, --cloud_provider_name=<name> object storage provider (e.g. AWS-S3, AZURE, S3-Compatible, etc.)
-t, --cloud_container_name=<name> container name for object storage
-o, --cloud_connection_string=<password> access key for object-direct storage
--mode=<large |standard |cloud-optimized> selects the type of storage configuration

    OR

    • $ sudo ./qs_inst_7.1.0.245.bin

      and follow the prompts to :

      • configure storage location (local, or object direct)
      • select an installation mode. Refer to QoreStor installation modes for more information
      • install QoreStor in object direct mode, and enter the required cloud connection information
      • [Optional] add firewall exceptions

Logging in to QoreStor

To access the QoreStor UI, you must connect via a supported browser.

To access the QoreStor UI

  1. In a supported browser, navigate to https://<hostname:5233>

    NOTE: You can use either the host IP or hostname.

  2. Log in with the default credentials:
    • username: admin
    • password: St0r@ge!

To access the QoreStor command line interface

  1. Using the terminal emulation application of your choice, connect to your QoreStor server.
  2. Starting with version 7.1, the qsadmin and qsservice users are not created on a fresh installation of QoreStor. Create a new user or employ an existing account to dedicate a user for QoreStor administration with the following command:

    /opt/qorestor/bin/setup_qs_user.sh <provide-user-namehere>

    For QoreStor instances created with OVAs or from Azure Marketplace, refer to the respective guides.

  3. At the system prompt, enter the username for an account with super user privileges.
  4. For a list of QoreStor CLI commands, refer to the Quest QoreStor Command Line Reference Guide.

Upgrading QoreStor

There are multiple options for upgrading your QoreStor software, allowing for flexibility to fit your environment and your comfort level with working in the Linux command line. Regardless of the method chosen, the QoreStor upgrade requires that the new binaries be downloaded from the Quest website and run on the QoreStor server. The upgrade methods accomplish this in different ways:

  • The QoreStor CLI - Through the QoreStor CLI 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 the QoreStor Command Line
  • 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 command line), 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 QoreStor CLI.  Refer to Upgrading QoreStor Software using the QoreStor UI.

Before 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 1GB of free space on the root partition.
  • 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.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.

  • 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.

IMPORTANT:QoreStor7.1 includes support for VTL protocols. To upgrade to QoreStor7.1 and enable VTL support, you must first run ./qs_inst_7.1.0.245.bin -- --install-vtl.

If you do not wish to enable VTL support, follow the upgrade procedure below.

Upgrading QoreStor instances on Microsoft Azure

For QoreStor instances running on Microsoft Azure, perform the actions below before upgrading to 7.1.0.245.

  • At the prompt, run 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
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating