Skip to main content
Druva Documentation

Re-register a Phoenix Backup Store

Phoenix Editions: File:/tick.png Business File:/cross.png Enterprise File:/tick.png Elite

The availability of this feature is limited based on the license type, region, and other criteria. To access this feature, contact your Druva Account Manager or Druva Support. This article/documentation is subject to change based on the continuous improvements to this feature.

Re-register a Phoenix Backup Store to replace it with a new or if it gets disconnected. The Phoenix Backup Store can get disconnected from the Phoenix Cloud if:

  • A hardware refresh has been performed on the Phoenix Backup Store
  • A Phoenix Backup Store is replaced with a different server
  • A Phoenix Backup Store virtual machine is deleted from the vCenter host

Re-registration ensures that all the settings on the existing Phoenix Backup Store such as backup mounts, retention settings, maximum bandwidth, and the IP whitelist are applied to the new Phoenix Backup Store. Phoenix does not break the snapshot chain of the Oracle RMAN backups uploaded to the Phoenix Cloud from the Phoenix Backup Store.

Prerequisites

Perform the following steps on the Phoenix Backup Store that you want to replace:

  1. Run the following command to stop the Phoenix Backup Store service:
    sudo service PhoenixBackupStore stop        
    
  2. Run the following command to remove the existing ZFS pool on the Phoenix Backup Store:
    zpool destroy -f Phoenix
    
  3. Run the following command to remove the existing the database state:
    rm -rf /var/Phoenix/ExportService/database.db
    
  4. Remove the existing entries from /etc/exports.

Ensure that the PhoenixBackupStore service on the old Phoenix Backup Store is stopped.

In addition, ensure that the network settings of the Ubuntu server or the virtual machine that you are re-registering with Phoenix matches the network settings of the Phoenix Backup Store it replaces.   

Download the package and generate activation token

The Phoenix Backup Store package is available on the Druva downloads page. In addition, you can download the package when you generate the activation token. If you want to:

  • Set up the Phoenix Backup Store on a physical appliance, download the Debian package 
  • Set up the Phoenix Backup Store as a virtual machine, download the Open Virtual Appliance (OVA) package

To generate the activation token: 

  1. Log in to the Phoenix Management Console.
  2. From the top menu, select the Organization where you want to configure the Phoenix Backup Store.
    The Organization page appears. 
  3. On the Organization page, click Protect > Oracle from the top-menu. 
    The Oracle page appears. 
  4. On the Oracle page, under the Phoenix Backup Stores tab, click the name of the Phoenix Backup Store that is disconnected. 
  5. On the Phoenix Backup Store page, click Re-Register Store. The Re-Register Phoenix Backup Store wizard appears. 
  6. In the first step of the wizard, read the information and click Proceed.
  7. In the Install Package section of the wizard, use the Click here link to launch the downloads page and download the package. If you have already downloaded the package, click Next.
  8. In the Generate Activation Token section of the wizard, provide:
    Field Description
    Token Description A string that can help you identify the token.
    This token can activate <the number of> stores The number of Phoenix Backup Stores that can be activated using this token.
    The token expires in The number of days after which the token cannot be used for activating a Phoenix Backup Store.
    After you provide the details above, click Next
  9. In the Store Activation section, Druva provides the token that you use to activate the Phoenix Backup Store. Copy the token, save it on a text file, and click Finish. You can also navigate to Manage > Tokens from the top menu bar to get the token again. 

Deploy the Debian package on an Ubuntu server and register the Phoenix Backup Store

The Debian package that you download is deployed on an Ubuntu server to create the Phoenix Backup Store. The mount created on the Phoenix Backup Store serves as the location to store Oracle RMAN backups. 

Prerequisite

Ensure that the package is accessible on the Ubuntu server.

Deploy the package

  1. Connect to the Ubuntu server using PuTTy or launch the terminal on the Ubuntu server. 
  2. Install the ZFS package on the Ubuntu server. The command to install the ZFS package is:
    sudo apt install zfsutils-linux=0.7.5-1*
    
  3. Install the NFS kernel package on the server. The command to install the NFS kernel package is:
    sudo apt install nfs-kernel-server=1:1.3.4-2.1*
  4.  On the terminal, run the dpkg command with the path to the Debian package to install it.
    sudo dpkg -i <path-to-the-Phoenix-Backup-Store-debian-package>
    For example:
    sudo dpkg -i /home/admin/Downloads/druva-phoenix-backupstore-4.7.6-110.amd64.deb

    Ensure that you provide the correct path to the location of the Debian package and its name.
    These steps install the ZFS package,  the NFS kernel, and the Druva binaries that Phoenix needs to create the Phoenix Backup Store. 

  5. After the package is installed, create a ZFS pool using the disks on the Ubuntu server. To create the ZFS pool, run the following script on the Phoenix Backup Store as the root user:
    zpool_config_no_raid.sh <uuid-of-disk1> <uuid-of-disk2> ... 

    For example:

    zpool_config_no_raid.sh 01234uuid-disk10000 121uuid-disk20000 4324uuid-disk30000

    To configure the ZFS pool with RAIDZ configuration, run the following script:

    zpool_config_raidz1.sh <uuid-of-disk1> <uuid-of-disk2> ...  

    For example: 

    zpool_config_raidz1.sh 01234uuid-disk10000 121uuid-disk20000 4324uuid-disk30000

    The above disk universal unique identifiers (UUIDs) are examples. Ensure that you provide the correct device name, device paths, or UUIDs when you create a ZFS pool. Druva recommends that you provide the disk UUIDs. To get the disk UUIDs, see UsingUUIDs [External link to Ubuntu Documentation]. For a RAIDZ configuration, use at least three disks. The scripts are stored under the /opt/Druva/Phoenix/PhoenixBackupStore/bin folder on the Phoenix Backup Store.

  6. Run the following command to restart the Phoenix Backup Store service:

    sudo service PhoenixBackupStore restart
  7.  After installing the package and configuring the ZFS pool, run the activation command with the token you generated above to activate the Phoenix Backup Store:

    PhoenixBackupStoreControl activate <govcloud> <activation_token>
    

    Example activation command for public cloud

    PhoenixBackupStoreControl activate ExampleToken1234
    

    Example activation command for Gov cloud

    PhoenixBackupStoreControl activate govcloud ExampleToken1234
    

    Ensure that you replace example values with real values. In the above syntax, replace ExampleToken1234 with the token that you generate when you perform the steps above

The Phoenix Backup Store is deployed and registered with Druva. 

Deploy the OVA package on a VMware setup and register the Phoenix Backup Store virtual machine

In addition to the Debian package, Druva provides an open virtual appliance (OVA) package that you can use to create a Phoenix Backup Store on a VMware setup. The OVA package that you download is deployed on a VMware setup to create the Phoenix Backup Store virtual machine. The mount created on the Phoenix Backup Store serves as the location to store Oracle RMAN backups. 

Before you begin

Ensure that the OVA package is downloaded.

Deploy the package

To deploy the Phoenix Backup Store OVA on a VMware setup, see Deploy an OVF or OVA template [External link to VMware documentation].

The OVA package can be deployed for vCenter/ESXi version 6.0 or later. After you deploy the Phoenix Backup Store OVA, start the virtual machine and connect to the virtual machine using PuTTy or any other remote utility. To log in to the Phoenix Backup Store enter:

  • root as the username
  • Druv@123 as the password 

After logging in, perform the following steps on the terminal:

  1. Create the ZFS pool using the virtual disks attached to the Phoenix Backup Store virtual machine. To create the ZFS pool, run the following script as the root user:
    zpool_config_no_raid.sh <uuid-of-disk1> <uuid-of-disk2> ...  

    For example:

    zpool_config_no_raid.sh 01234uuid-disk10000 121uuid-disk20000 4324uuid-disk30000

    To configure the ZFS pool with RAIDZ configuration, run the following script:

    zpool_config_no_raid.sh <uuid-of-disk1> <uuid-of-disk2> ...  

    For example:

    zpool_config_raidz1.sh 01234uuid-disk10000 121uuid-disk20000 4324uuid-disk30000

    The above device universal unique identifiers (UUIDs) are examples. Ensure that you provide the correct device name, device paths, or UUIDs when you create a ZFS pool. Druva recommends that you provide the disk UUIDs. You can get the  For a RAIDZ configuration, use at least three disks. The scripts are stored under the /opt/Druva/Phoenix/PhoenixBackupStore/bin folder on the Phoenix Backup Store.

  2. Run the following command to restart the Phoenix Backup Store service. 
    sudo service PhoenixBackupStore restart 
  3. Run the activation command with the token you generated above to activate the Phoenix Backup Store:
    PhoenixBackupStoreControl activate <govcloud> <activation_token>
    

    Example activation command for Public cloud:

    PhoenixBackupStoreControl activate ExampleToken1234
    

    Example activation command for Gov cloud:

    PhoenixBackupStoreControl activate govcloud ExampleToken1234

    Ensure that you replace example values with real values. In the above syntax, replace ExampleToken1234 with the token that you generate when you perform the steps above

The Phoenix Backup Store is deployed and registered with Druva. 

Ensure that you use this activation token for the correct Phoenix Backup Store. If you use this token on a different store, backup jobs will fail on this store as well on the Phoenix Backup Store you originally wanted to re-register. In addition, on the Phoenix Backup Stores tab of the Oracle page, details of the other Phoenix Backup Store  become identical to the Phoenix Backup Store you originally wanted to re-register. 

Reuse a Phoenix Backup Store

You can reuse an older Phoenix Backup Store. However, before you reuse the Phoenix Backup Store, ensure that certain Phoenix files are removed from it. Perform the following steps to clean up a Phoenix Backup Store for reuse:

  1. Run the following command to remove the existing ZFS pool on the Phoenix Backup Store:
    zpool destroy -f Phoenix
    
  2. Run the following command to remove the existing the database state:
    rm -rf /var/Phoenix/ExportService/database.db
    
  3. Remove the existing entries from /etc/exports.

After performing the steps above, follow the steps in the deploy and register a Phoenix Backup Store article and register it as a new Phoenix Backup Store.