Chat now with support
Chat with Support

QoreStor 7.4.1 - Installation Guide

Installing QoreStor in Object Direct mode

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.4.1.169.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.4.1.169.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> -w <cloud-connection-string>

Use the following table to define the parameters:

Table 5: Object Direct mode installation parameter definitions
Parameter Definition
-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> cloud container name for object storage
-w, --cloud_connection_string=<password> cloud connection string for the object storage account
--mode=<large |standard |cloud-optimized> selects the type of storage configuration
--install-vtl install support for VTL
--no-vtl do not install support for VTL
--install-cifs install support for CIFS and AD
--no-cifs do not install support for CIFS or AD
--install-nfs install support for NFS
--no-nfs do not install support for NFS
--install-object-container install Object Container support
--no-object-container do not install Object Container support
--enable-cloud enables the support for cloud-tiering and archive-tiering
--no-cloud install QoreStor without support for the cloud-tiering and archive-tiering

    Or

    • $ sudo ./qs_inst_7.4.1.169.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.

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 in Object Direct mode.

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.4.1.169.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.4.1.169.bin -- -f –p <repository_path> -m <metadata_path> --mode=<cloud-optimized|standard|large> --accept-eula --install-deps [--install-vtl]

      where the following parameter definitions are true:

    • -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=<cloud-optimized|standard|enterprise|enterprise-plus> specifies the installation mode. Refer to QoreStor installation modes for more information.
      • cloud-optimized: 43 TB max storage, 64 GB dictionary.
      • standard: 150 TB max. storage, 256 GB dictionary.
      • enterprise: 360 TB max storage, 256 GB dictionary.
      • enterprise plus : 512 TB max storage, 384 GB dictionary, 64 GB cloud-tier 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 the VTL support.
    • --enable-cloud: enables the support for cloud-tiering and archive-tiering.
    • --no-cloud: install the QoreStor without support for cloud-tiering and archive-tiering.
    • --install-cifs: install support for CIFS and AD.
    • --no-cifs : do not install support for CIFS or AD.
    • --install-nfs: install the support for NFS.
    • --no-nfs : do not install support for NFS.
    • --install-object-container : install Object Container support.
    • --no-object-container: do not install Object Container support.

    OR

    • $ sudo ./qs_inst_7.4.1.169.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

      NOTE: To install VTL support, it is recommended to boot the QoreStor system with secure boot disabled..

Installing Qorestor with Protocols of Choice

For QoreStor fresh installation, the RDS protocol support is mandatory while NFS, CIFS, VTL, and Object Container protocol support is optional. QoreStor installer will not add the missing protocol package/s at the time of upgrading software to a newer version. However, the user can choose to install the missing protocol support at a later stage using following options:
qs_installer.bin --[--install-nfs|--install-cifs |--install-vtl |--install-object-container] option.
After the installation of selected protocol, QoreStor enables the support for respective container types.
QoreStor installation with protocols of choice is done with one of the following methods.

Interactive mode standard QoreStor installation with protocols of choice

To perform interactive mode installation of QoreStor with protocols of choice, execute the following command and continue with supported navigation

# ./qs_inst_7.4.1.169.bin

NOTE:User is advised to accept the EULA. Continue with the further navigation.

      Following is the CLI output displayed while installation.

      [root@ol8_small_qs1 ~]# ./qs_inst_7.4.1.169.bin
      Verifying archive integrity... 100% MD5 checksums are OK. All good.
      Uncompressing QoreStor Server 7.4.1.169 100%

      === Checking server version ...

      Install/Upgrade Version: 7.4.1.169
      Getting object direct parameters...
      Object Direct Storage is available for storing data in the cloud.
      If you choose this option, you would be expected to enter a valid cloud connection string at a later stage.
      NOTE: VTL is not supported with Object Direct Storage. If you choose this option, VTL support will not be installed.
      Would you like to configure Object Direct Storage for storing data? yes/no:
      no
      Getting path information...
      Please provide the path for the storage repository: [/]
      /QSdata
      Optionally, please provide a path for metadata storage: [/QSdata]
      /QSmetadata
      Please select a storage configuration:
      Enterprise-Plus: 512 TB maximum storage capacity, 384 GB dictionary
      Enterprise: 360 TB maximum storage capacity, 256 GB dictionary
      Standard: 150 TB maximum storage capacity, 256 GB dictionary
      Small (Cloud-Optimized): 43 TB maximum storage capacity, 256 GB dictionary
      1) Enterprise-Plus 3) Standard
      2) Enterprise 4) Small (Cloud-Optimized)
      #? 4
      Small (Cloud-Optimized) configuration selected

      === Configuration Mode: cloud-optimized ===

      Do you wish to enable support for Cloud Tier and Archive Tier? yes/no: no
      Cloud Tier and Archive Tier support will not be installed.
      iSCSI and NDMP VTL support is available for this kernel.
      Note: Installing support for iSCSI and NDMP VTL will consume additional memory and introduce a kernel dependency.
      As a result, kernel upgrades will be limited while QoreStor is present.
      Choose this option only if you require iSCSI and NDMP VTL.
      Do you wish to install support for VTL? yes/no: no
      VTL support will not be installed.
      CIFS support is available.
      Do you wish to install CIFS support? yes/no: yes
      CIFS support will be installed.
      NFS support is available.

      NOTE: Please note that NFS support is required for Instant Restore of CDP backups written to RDS containers.

      Do you wish to install NFS support? yes/no: yes
      NFS support will be installed.
      Object Container support is available.
      Do you wish to install Object Container support? yes/no: yes
      Object Container support will be installed.


      Checking dependencies:
      ...Checking nfs-utils... yes
      ...Checking policycoreutils... yes
      ...Checking glibmm24... yes
      ...Checking krb5-libs >= 1.15.1.18... yes
      ...Checking libsemanage >= 2.5.8... yes
      ...Checking libaio... yes
      ...Checking perl... yes
      ...Checking mutt... yes
      ...Checking yum-utils... yes
      ...Checking bind-utils... yes
      ...Checking libnsl... yes
      ...Checking boost... yes
      ...Checking xmlrpc-c... yes
      ...Checking xmlrpc-c-client... yes
      ...Checking bzip2-devel... yes
      ...Checking rpcbind... yes
      ...Checking libidn... yes
      ...Checking attr... yes
      ...Checking sqlite... yes
      ...Checking libxml2... yes
      ...Checking rsyslog... yes
      ...Checking openssl... yes
      ...Checking lsof... yes
      ...Checking python36... yes
      ...Checking lsscsi... yes
      ...Checking audit-libs... yes
      ...Checking jq... yes
      ...Checking libxslt-devel... yes
      ...Checking libxml2-devel... yes
      ...Checking python36-devel... yes
      ...Checking gcc... yes

      === Evaluating System...
      --
      Supported Linux Distributions: rhel ol rocky almalinux
      Found Linux Distribution: ol
      OS Test: PASS
      --
      Supported Kernel Versions: 4.18.0-477 4.18.0-513 4.18.0-553
      Found Kernel: 4.18.0-513
      Kernel Test: PASS
      --
      Min. Required # of CPU Cores: 4
      Actual # of CPU Cores: 4
      CPU Test: PASS
      --
      Min. Required System Memory (GB): 32
      Actual System Memory (GB): 32
      Memory Test: PASS
      --
      Min. Required Available Space in /QSdata (GB): 500
      Actual Available Space in /QSdata (GB): 989
      Available Space Test: PASS
      === Running IOPS tests...
      Min. Required Seq. Write IOPS for /QSdata: 450
      Actual Seq. Write IOPS for /QSdata: 45383
      Seq. IOPS Test: PASS
      Min. Required Random Write IOPS for /QSdata: 450
      Actual Random Write IOPS for /QSdata: 38045
      Random IOPS Test: PASS
      Min. Required Available Space in /QSmetadata (GB): 400
      Actual Available Space in /QSmetadata (GB): 1025
      Available Space Test: PASS

      === Running IOPS tests...
      Min. Required Seq. Write IOPS for /QSmetadata: 450
      Actual Seq. Write IOPS for /QSmetadata: 42921
      Seq. IOPS Test: PASS
      Min. Required Random Write IOPS for /QSmetadata: 6000
      Actual Random Write IOPS for /QSmetadata: 35616
      Random IOPS Test: PASS
      --
      ... Done ===

      Required Mount Options for /QSdata: noatime
      Found Options for /QSdata: noatime
      Required Mount Options for /QSmetadata: noatime
      Found Options for /QSmetadata: noatime
      === Preparing components for install/upgrade...
      === Installing Version 7.4.1.169...
      Stopping service: ...
      Installing component: samba
      Installing component: PBIS-OPEN
      Installing component: oca-libs
      Installing component: choam-prod-1
      Installing component: storage-server-el
      Installing component: qs-libfuse3-3
      Installing component: objstor-minio-20230320201618
      Installing component: qorestor-ui
      ... Done.

      === Configuring system...
      Repository Path: /QSdata
      Metadata Path: /QSmetadata
      [Tue Jul 16 01:49:11 PDT 2024] Configuring time-series database...[Done]
      Would you like to automatically add firewall exceptions for ports used by storage-server? yes/no:
      yes
      [Tue Jul 16 01:52:23 PDT 2024] Initializing configuration files... [Done]
      [Tue Jul 16 01:52:23 PDT 2024] Creating and initializing ingest buffer...[Done]
      [Tue Jul 16 01:53:32 PDT 2024] Creating and initializing de-duplication dictionary... [Done]
      [Tue Jul 16 01:53:32 PDT 2024] Checking for and generating self-signed certificate...
      [Done]
      [Tue Jul 16 01:53:33 PDT 2024] Checking for and generating SAML SP certificate...
      [Done]
      [Tue Jul 16 01:53:33 PDT 2024] Installing services... [Done]
      [Tue Jul 16 01:53:33 PDT 2024] Initializing services... [Done]
      [Tue Jul 16 01:53:35 PDT 2024] Adding firewall exceptions... [Done]
      ... Done.

      Checking for and installing required python packages...... Done.
      === Server installed/upgraded 7.4.1.169 successfully.
      === Starting services ===
      Starting service: choam ...
      Stopping service: ...
      Starting service: ocards ...
      ... Done.
      === Management interface: https://ol8_small_qs1.ocarina.local:5233 ===

      Silent mode installation with protocols of choice

      Silent mode installation with protocols of choice executes QoreStor installation in cloud optimized mode with support for CIFS and NFS protocols along with mandatory RDS protocol installation. To choose correct mode, size of installation, and required protocol support, refer to Installing QoreStor in Object Direct mode, table number 5.
      The following example shows the above mentioned installation process.

      # ./qs_inst_7.4.1.169.bin -- -f -p /Qorestor -m /QSmetadata --accept-eula --install-deps --fix-mount-opts --no-vtl --no-object-container --no-object-direct --mode=cloud-optimized --install-cifs --install-nfs

      Adding protocol support post QoreStor installation

      You can add the missing protocol support to the installation by passing the appropriate arguments to the installer from the following options
      [--install-nfs|--install-cifs |--install-vtl |--install-object-container]

      Example:-

      For installing VTL support
      # ./qs_inst_7.4.1.169.bin -- --install-vtl


      For installing the CIFS protocol
      # ./qs_inst_7.4.1.169.bin -- --install-cifs

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!

NOTE: Change the default password when you first log in to QoreStor.

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.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating