Chat now with support
Chat with Support

QoreStor 7.1.1 - Installation Guide

Installing QoreStor

Before installing QoreStor, refer to System requirements and Installing QoreStor for additional information. To install QoreStor in Object Direct mode, refer to Installing QoreStor with Object Direct Storage.

To install QoreStor

  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.1.162.bin

  3. With elevated privileges (either as root or with the sudo command), run the installation script according to one of the two options below
    • qs_inst_7.1.1.162.bin -- -f –p <repository_path> -m <metadata_path> --mode=<demo|cloud-optimized|standard|large> --accept-eula --install-deps --[install-vtl]

      where

    • -f specifies that the installer should automatically apply firewall rules to open the necessary ports
    • -p <repository_path> specifies the repository path
    • -m <metadata_path> specifies where the dictionary and journals should be stored.If not specified, the repository path will be used.
    • --mode=<demo|cloud-optimized|standard|large> specifies the installation mode. Refer to QoreStor installation modes for more information.
      • demo: 100GB max storage, 1GB dictionary
      • cloud-optimized: 43TB max storage, 64GB dictionary
      • standard: 150TB max. storage, 256GB dictionary
      • Large: 360TB max storage; 256GB dictionary
    • --accept-eula: implicitly accepts the EULA and bypasses the prompt to accept the terms and conditions of the EULA
    • --install-deps: implicit permission to download and install the nfs-utils and policycoreutils packages if they are not already installed
    • --install-vtl: [Optional] installs components required for VTL support.

    OR

    • $ sudo ./qs_inst_7.1.1.162.bin

      and follow the prompts to :

      • provide a path for the storage directory
      • [Optional] provide a separate path for metadata storage
      • select an installation mode. Refer to QoreStor installation modes for more information
      • [Optional] install VTL support
      • [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.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.1 includes support for VTL protocols. To upgrade to QoreStor7.1.1 and enable VTL support, you must first run ./qs_inst_7.1.1.162.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.1.162.

  • 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