4.1 Get Started
Page tree

Versions Compared

Old Version 19

changes.mady.by.user Tetyana Tsyupka

Saved on

compared with

New Version Current

changes.mady.by.user Marta Dubno

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
 This section is the part of the OnApp installation procedure.
 Install Control Panel Server > Install Compute Resources > Install Data Stores > Install Backup Server > Download and Configure Templates on Control Panel Server > Configure Cloud

 

 

Follow one of two processes to set up a backup server in your cloud:

  • Install Static Backup Server
  • Install CloudBoot Backup Server

Choose the one that suits you best.

On this page:

Table of Contents

 


 

See also:

Install Control Panel Server

Install Data Stores

Technical Details

OnApp 4.1 Preparation Guide

OnApp v.4.0 to v.4.1 Upgrade Guide

 

Search for other docs:

Livesearch

Install Static Backup Server

 

To install static backup server, run the following procedure. Skip this section if you are using a CloudBoot method. We recommend installing CentOS from the minimal CentOS ISO for static backup servers.

 

  1. Add a backup server via the Control Panel user interface:

    1. Go to your Control Panel's Settings menu, then press Backup servers icon.
    2. Click the Create Backup Server button.
    3. Fill in the form that appears:
      • Label - give your backup server a label
      • IP address - enter the backup server IP address (IPv4)
      • Backup IP address - add a provisioning network IP address
      • Capacity - set the backup server capacity (in GB)
      • Backup server zone - select the backup server zone to which this backup server will be assigned.

    4. Move the Enabled slider to the right to enable the backup server.
    5. Click the Add Backup Server button.
     

  2. Update your server:

    Code Block
    bash# yum update

  3. Download the OnApp repository:

    Code Block
    bash# rpm -Uvh http://rpm.repo.onapp.com/repo/onapp-repo-4.1.noarch.rpm


  4. Install the OnApp Backup Server installer package:

    Code Block
    bash# yum install onapp-bk-install

  5. Anchor
    config
    config
    Check and set Backup Server default settings:

    Expand
    titleEdit Backup Server default settings by editing the /onapp/onapp-bk.conf file:

    OnApp BK tools custom version

    Code Block
    BK_VERSION=""

    OnApp StorageAPI custom version

    Code Block
    API_VERSION=""

    Default server to synch time on the HV

    Code Block
    NTP_TIME_SERVER='pool.ntp.org'

    The number of retries for WGET to download the file

    Code Block
    WGET_TRIES=5

    OnApp templates directory.

    Note
    Please refer to the corresponding settings at OnApp Control Panel web interface
    Code Block
    TEMPLATES_DIR='/onapp/templates'

    OnApp backups directory.

    Note
    Please refer to the corresponding settings at OnApp Control Panel web interface
    Code Block
    BACKUPSS_DIR='/onapp/backups'
    Code Block
    bash# vi /onapp/onapp-bk.conf

     

  6. Anchor
    installer
    installer
    Run the installer. It is recommended to download Base, Load Balancer and CDN templates while running the installer. You may rerun the installer later with the -t option.

    Code Block
    bash# sh /onapp/onapp-bk-install/onapp-bk-install.sh
    Expand
    titleThe full list of installer options:

    Usage:

    Code Block
    /onapp/onapp-bk-install/onapp-bk-install.sh [-c CONFIG_FILE] [-a] [-y] [-t] [-h]

    Where:

    -c CONFIG_FILE

    Custom installer configuration file. Otherwise, preinstalled one is used.

    -a

    Do NOT be interactive. Processe with automatic installation.

    -y

    Update OS packages (except of OnApp provided) on the box with 'yum update'.

    -t

    Initiate Base, Load Balancer and CDN templates download.

    The download is initiated if '-a' option is used.

    -h

    Print this info

     

     

  7. Сonfigure the backup server for your cloud. This step is also required for the SNMP statistics receiver configuration:

    Code Block
    bash#> /onapp/onapp-bk-install/onapp-bk-config.sh -h <CP_HOST_IP> -p [BK_HOST_IP] -f <FILE_TRANSFER_SERVER_IP>
    Expand
    titleThe full list of configuration options:

    Usage:

    Code Block
    /onapp/onapp-bk-install/onapp-bk-config.sh [-h CP_HOST_IP] [ -p BK_HOST_IP] [-f FTS_IP] [-a|-i [USER:PASSWD]] [-s] -?

    Where:

    -h CP_HOST_IP

     FQDN or IP Address of the management server which should receive all status reports and is authoritative for this backup server.

    -p BK_HOST_IP

     FQDN or IP Address of Backup Server which will serve all stats related and other requests send by the CP_HOST_IP.

    Used by snmpd and StorageAPI.

    -f FTS_IP

     File Transfer Server FQDN or IP address used for daily cron update recovery ISO by recovery.sh

    -a

     Install AoE

    -i [USER:PASSWD]

     Install iSCSI utils and configure with USER and PASSWD (if specified)

    -s

     Install sshfs

    -?

     Print this help info

     

    Ignore any errors stating stats and that vmon services aren't running. This is the expected behaviour at this stage.


Install CloudBoot Backup Server

 

CloudBoot backup servers are CloudBooted KVM compute resources that can be be used as backup servers. Follow the step-by-step instructions provided in this chapter to configure CloudBoot backup servers in your cloud.

  • You should configure some local or remote attached storage for persistent backups on the provisioning/backup server.
  • We strongly recommend you to deploy one or more backup servers on your cloud, Incremental backups are only supported with a dedicated backup server.

To create a CloudBoot backup server:

  1. Update CloudBoot and CP server RPMs:

    Code Block
    yum update onapp-store-install yum update onapp-cp-install

  2. Configure CloudBoot settings:

    Code Block
    /onapp/onapp-store-install/onapp-store-install.sh

  3. Create new CloudBoot compute resource with an IP address from the dynamic range. Refer to the Create CloudBoot Compute resource section of the Admin guide for details.

  4. Ensure to choose the 'Backup' option and don't format disks.

  5. Go to your Control Panel's Settings menu, then press Backup Servers icon.
  6. Click the Create Backup Server button. 
  7.  Fill in the form that appears:
    Tick the Enabled box to enable the backup server.
    • Label - give your backup server a label
    • IP address - enter the IP address of a compute resource you have created at step 1
    • Backup IP address - add a provisioning network IP address
    • Capacity - set the backup server capacity (in GB)
  8. After that, assign your backup server to the backup server zone.

    If you intend to attach LVM-based storage and create backups, you should also add the IP address of the KVM compute resource added in step 1 in the 'Backup IP address' field of each of your compute resources.

 

Further steps:

  1. Format and mount the local storage:
    1. SSH to the backup server

    2. Format the storage with your preferred filesystem type, e.g.:

      Code Block
      bash#> mkfs.ext4 /dev/sda

    3. Make folder for backups if it does not exist

      Code Block
      bash#> mkdir /backupstorage

    4. Mount the storage to /onapp/backups:

      Code Block
      bash#> mount /dev/sda /backupstorage

    5. Make folder for storing templates:

      Code Block
      bash#> mkdir /backupstorage/templates

    6. Make folder for storing backups:

      Code Block
      bash#> mkdir /backupstorage/backups

    7. Create symbolic links in /onapp

      Code Block
      bash#> ln -s /backupstorage/backups /onapp/backups

    8.  Add the following to custom config file:

      Code Block
      mkdir /backupstorage
mount /dev/sda /backupstorage
ln -s /backupstorage/backups /onapp/backups
ln -s /backupstorage/templates /onapp/templates



  2. Update the database so that the location of the templates is known:

     

    a. Find the database password:

    Code Block
    cat /onapp/interface/config/database.yml |grep password

    b. Open the onapp database in MySQL: 

    Code Block
    bash#> mysql -p bash#> use onapp;

    c. Find the ID of the backup server:

    Code Block
    bash#> select * from backup_servers;

    d. For all of the templates, set the required backup_server_id:

    Code Block
    bash#> update templates set backup_server_id='[your_id]';
  3. To download the base templates during the installation to your Control Panel, download and run the following script:

     

    Code Block
    bash#> wget http://downloads.repo.onapp.com/get_template.sh
bash#> /bin/sh get_template.sh
    Note
    To ensure your backups don't disappear after rebooting the CloudBoot backup server, add a mount command to the CloudBoot backup servers custom config so it is automatically mounted after future reboots.

    To fix your custom config settings, you can use one of the following options provided in the examples below (you will have to specify your own device names):

    1. If you have a separate partition for backups and templates (/dev/sda1 and /dev/sda2)

      Code Block
      mkdir -p /onapp/backups
mkdir -p /onapp/template
mount /dev/sda1 /onapp/backups
mount /dev/sda2 /onapp/templates

    2. If you current array is detected as /dev/sda1 and currently everything is located in /onapp within templates and backup directories within:

      Code Block
      mkdir -p /onapp
mount /dev/sda1 /onapp

 

 

 

 This section is the part of the OnApp installation procedure.
Install Control Panel Server > Install Compute Resources > Install Data Stores > Install Backup Server > Download and Configure Templates on Control Panel Server > Configure Cloud