summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorToma Bilius <toma.bilius@enea.com>2021-08-12 13:14:08 +0300
committerToma Bilius <toma.bilius@enea.com>2021-08-12 13:14:35 +0300
commit994a612560ec09a71d67f7521920e8e01ad243f3 (patch)
tree6962bd92d66b05b0be893aea2c64b96aff710027
parent11db30366663a8f049c71a29d574e01da05e4dc1 (diff)
downloadnfv-access-documentation-994a612560ec09a71d67f7521920e8e01ad243f3.tar.gz
ELCCR-1658 Onboarded VNFs cannot be restored when using NFVi Backup
Change-Id: I05948ff41f9c23ad2b2f4180c2a0ab8a319254d9 Signed-off-by: Toma Bilius <toma.bilius@enea.com>
-rw-r--r--doc/book-enea-edge-getting-started/doc/advanced_configurations.xml278
1 files changed, 142 insertions, 136 deletions
diff --git a/doc/book-enea-edge-getting-started/doc/advanced_configurations.xml b/doc/book-enea-edge-getting-started/doc/advanced_configurations.xml
index 518d9ec..14981e9 100644
--- a/doc/book-enea-edge-getting-started/doc/advanced_configurations.xml
+++ b/doc/book-enea-edge-getting-started/doc/advanced_configurations.xml
@@ -514,8 +514,8 @@ node0.1048576kB = 3 </programlisting>
514 Archive Table</emphasis> and the <emphasis 514 Archive Table</emphasis> and the <emphasis
515 role="bold">BackupArchiveCreated</emphasis> event can be seen by 515 role="bold">BackupArchiveCreated</emphasis> event can be seen by
516 accessing the <emphasis role="bold">Fault</emphasis> menu and triggering 516 accessing the <emphasis role="bold">Fault</emphasis> menu and triggering
517 the <emphasis role="bold">Events</emphasis> window. The backup 517 the <emphasis role="bold">Events</emphasis> window. The backup file will
518 file will be created on the uCPE device.</para> 518 be created on the uCPE device.</para>
519 </section> 519 </section>
520 520
521 <section id="restore_nfvi_backup"> 521 <section id="restore_nfvi_backup">
@@ -563,6 +563,12 @@ node0.1048576kB = 3 </programlisting>
563 Instances that were present at the moment the backup was taken will be 563 Instances that were present at the moment the backup was taken will be
564 restored to their initial state, as if newly created. All snapshots 564 restored to their initial state, as if newly created. All snapshots
565 associated with previously instantiated VNFs will be deleted.</para> 565 associated with previously instantiated VNFs will be deleted.</para>
566
567 <note>
568 <para>If the VNF descriptor associated with the VNFs that were saved
569 as part of the backup is deleted after the backup is performed, then a
570 backup restore will not be able to recreate those VNFs.</para>
571 </note>
566 </section> 572 </section>
567 573
568 <section id="delete_nfvi_backup"> 574 <section id="delete_nfvi_backup">
@@ -598,161 +604,161 @@ node0.1048576kB = 3 </programlisting>
598 </section> 604 </section>
599 605
600 <section id="mgmt_db_backup"> 606 <section id="mgmt_db_backup">
601 <title>Database backup for the Enea Edge Management application</title> 607 <title>Database backup for the Enea Edge Management application</title>
602 608
603 <para>The following handles advanced configuration for a database 609 <para>The following handles advanced configuration for a database backup.
604 backup. A backup can be used to restore the database in case 610 A backup can be used to restore the database in case of corruption.</para>
605 of corruption.</para> 611
606
607 <section id="db_backup_once"> 612 <section id="db_backup_once">
608 <title>One-time backup of the database</title> 613 <title>One-time backup of the database</title>
609
610 <para>The following steps are used to perform a database backup
611 from the Enea Edge Management application:</para>
612
613 <orderedlist>
614 <listitem>
615 <para>In the <emphasis role="bold">System Backup</emphasis> window,
616 select the <emphasis role="bold">Backups</emphasis> tab.</para>
617 </listitem>
618 614
619 <listitem> 615 <para>The following steps are used to perform a database backup from the
620 <para>Press the <emphasis role="bold">Backup Now</emphasis> button 616 Enea Edge Management application:</para>
621 in the <emphasis role="bold">Backups</emphasis> tab.</para>
622 </listitem>
623 617
624 <listitem> 618 <orderedlist>
625 <para>In the new window select the 619 <listitem>
626 <emphasis role="bold">Database Export</emphasis> option from 620 <para>In the <emphasis role="bold">System Backup</emphasis> window,
627 the <emphasis role="bold">Backup Type</emphasis> drop-down.</para> 621 select the <emphasis role="bold">Backups</emphasis> tab.</para>
628 </listitem> 622 </listitem>
629 623
630 <listitem> 624 <listitem>
631 <para>Set the <emphasis role="bold">Execution</emphasis> option 625 <para>Press the <emphasis role="bold">Backup Now</emphasis> button
632 to <emphasis role="bold">Now</emphasis>.</para> 626 in the <emphasis role="bold">Backups</emphasis> tab.</para>
633 </listitem> 627 </listitem>
634 628
635 <listitem> 629 <listitem>
636 <para>Press the <emphasis role="bold">Execute</emphasis> button 630 <para>In the new window select the <emphasis role="bold">Database
637 and wait until the Status message shows: 631 Export</emphasis> option from the <emphasis role="bold">Backup
638 <emphasis role="bold">System Backup Completed</emphasis>.</para> 632 Type</emphasis> drop-down.</para>
639 </listitem> 633 </listitem>
640 </orderedlist> 634
641 635 <listitem>
642 <para>Once the backup is successfully executed it will be visible in 636 <para>Set the <emphasis role="bold">Execution</emphasis> option to
643 the <emphasis role="bold">System Backup</emphasis> window with a 637 <emphasis role="bold">Now</emphasis>.</para>
644 name that respects the following format: 638 </listitem>
645 <literal>DatabaseExport_[date]_[timestamp].zip</literal>.</para> 639
640 <listitem>
641 <para>Press the <emphasis role="bold">Execute</emphasis> button and
642 wait until the Status message shows: <emphasis role="bold">System
643 Backup Completed</emphasis>.</para>
644 </listitem>
645 </orderedlist>
646
647 <para>Once the backup is successfully executed it will be visible in the
648 <emphasis role="bold">System Backup</emphasis> window with a name that
649 respects the following format:
650 <literal>DatabaseExport_[date]_[timestamp].zip</literal>.</para>
646 </section> 651 </section>
647 652
648 <section id="db_backup_restore"> 653 <section id="db_backup_restore">
649 <title>Restoring the database from a backup</title> 654 <title>Restoring the database from a backup</title>
650
651 <para>The following steps are used to perform a database restore
652 from the Enea Edge Management application:</para>
653
654 <orderedlist>
655 <listitem>
656 <para>In the <emphasis role="bold">System Backup</emphasis> window,
657 select the <emphasis role="bold">Backups</emphasis> tab.</para>
658 </listitem>
659 655
660 <listitem> 656 <para>The following steps are used to perform a database restore from
661 <para>Select the backup you want to restore from the list.</para> 657 the Enea Edge Management application:</para>
662
663 <note>
664 <para>Database backups follow the naming convention:
665 <literal>DatabaseExport_[date]_[timestamp].zip</literal>.</para>
666 </note>
667 </listitem>
668 658
669 <listitem> 659 <orderedlist>
670 <para>Click the <emphasis role="bold">Restore</emphasis> button.</para> 660 <listitem>
671 </listitem> 661 <para>In the <emphasis role="bold">System Backup</emphasis> window,
662 select the <emphasis role="bold">Backups</emphasis> tab.</para>
663 </listitem>
672 664
673 <listitem> 665 <listitem>
674 <para>In the window that appears, click 666 <para>Select the backup you want to restore from the list.</para>
675 <emphasis role="bold">OK</emphasis> to proceed with the
676 restore operation.</para>
677 </listitem>
678 667
679 <listitem> 668 <note>
680 <para>Follow the instructions in the pop-up window to restart 669 <para>Database backups follow the naming convention:
681 the server using the CentOS 7 command:</para> 670 <literal>DatabaseExport_[date]_[timestamp].zip</literal>.</para>
682 671 </note>
683 <programlisting>sudo systemctl restart ucpemanager.service</programlisting> 672 </listitem>
684 </listitem> 673
685 </orderedlist> 674 <listitem>
675 <para>Click the <emphasis role="bold">Restore</emphasis>
676 button.</para>
677 </listitem>
678
679 <listitem>
680 <para>In the window that appears, click <emphasis
681 role="bold">OK</emphasis> to proceed with the restore
682 operation.</para>
683 </listitem>
684
685 <listitem>
686 <para>Follow the instructions in the pop-up window to restart the
687 server using the CentOS 7 command:</para>
688
689 <programlisting>sudo systemctl restart ucpemanager.service</programlisting>
690 </listitem>
691 </orderedlist>
686 </section> 692 </section>
687 693
688 <section id="db_scheduled_backup"> 694 <section id="db_scheduled_backup">
689 <title>Scheduled backup of the database</title> 695 <title>Scheduled backup of the database</title>
690
691 <para>The following steps are used to perform a scheduled database backup
692 from the Enea Edge Management application:</para>
693
694 <orderedlist>
695 <listitem>
696 <para>In the <emphasis role="bold">System Backup</emphasis> window,
697 select the <emphasis role="bold">Backups</emphasis> tab.</para>
698 </listitem>
699 696
700 <listitem> 697 <para>The following steps are used to perform a scheduled database
701 <para>Press the <emphasis role="bold">Backup Now</emphasis> button 698 backup from the Enea Edge Management application:</para>
702 in the <emphasis role="bold">Backups</emphasis> tab.</para>
703 </listitem>
704 699
705 <listitem> 700 <orderedlist>
706 <para>In the new window select the 701 <listitem>
707 <emphasis role="bold">Database Export</emphasis> 702 <para>In the <emphasis role="bold">System Backup</emphasis> window,
708 option from the <emphasis role="bold">Backup Type</emphasis> drop-down.</para> 703 select the <emphasis role="bold">Backups</emphasis> tab.</para>
709 </listitem> 704 </listitem>
710 705
711 <listitem> 706 <listitem>
712 <para>Set the <emphasis role="bold">Execution</emphasis> option 707 <para>Press the <emphasis role="bold">Backup Now</emphasis> button
713 to <emphasis role="bold">Scheduled</emphasis>.</para> 708 in the <emphasis role="bold">Backups</emphasis> tab.</para>
714 </listitem> 709 </listitem>
715 710
716 <listitem> 711 <listitem>
717 <para>Fill in the <emphasis role="bold">Description</emphasis> field.</para> 712 <para>In the new window select the <emphasis role="bold">Database
718 </listitem> 713 Export</emphasis> option from the <emphasis role="bold">Backup
714 Type</emphasis> drop-down.</para>
715 </listitem>
719 716
720 <listitem> 717 <listitem>
721 <para>Set the <emphasis role="bold">Begin Date</emphasis>.</para> 718 <para>Set the <emphasis role="bold">Execution</emphasis> option to
722 </listitem> 719 <emphasis role="bold">Scheduled</emphasis>.</para>
720 </listitem>
723 721
724 <listitem> 722 <listitem>
725 <para>Fill in the non-mandatory fields accordingly.</para> 723 <para>Fill in the <emphasis role="bold">Description</emphasis>
726 724 field.</para>
727 <note> 725 </listitem>
728 <para>The <emphasis role="bold">End Date</emphasis> field becomes
729 available once the <emphasis role="bold">Periodicity</emphasis> option
730 is set to something other than
731 <emphasis role="bold">Once</emphasis>.</para>
732 </note>
733 </listitem>
734 726
735 <listitem> 727 <listitem>
736 <para>Click the <emphasis role="bold">Schedule</emphasis> button to 728 <para>Set the <emphasis role="bold">Begin Date</emphasis>.</para>
737 schedule the backup.</para> 729 </listitem>
738 </listitem> 730
739 </orderedlist> 731 <listitem>
732 <para>Fill in the non-mandatory fields accordingly.</para>
733
734 <note>
735 <para>The <emphasis role="bold">End Date</emphasis> field becomes
736 available once the <emphasis role="bold">Periodicity</emphasis>
737 option is set to something other than <emphasis
738 role="bold">Once</emphasis>.</para>
739 </note>
740 </listitem>
741
742 <listitem>
743 <para>Click the <emphasis role="bold">Schedule</emphasis> button to
744 schedule the backup.</para>
745 </listitem>
746 </orderedlist>
747
748 <figure>
749 <title>Scheduled Backup Configuration Example</title>
750
751 <mediaobject>
752 <imageobject>
753 <imagedata align="center" contentwidth="615"
754 fileref="images/scheduled_backup.png" />
755 </imageobject>
756 </mediaobject>
757 </figure>
740 758
741 <figure> 759 <para>The backups created will be visible in the <emphasis
742 <title>Scheduled Backup Configuration Example</title> 760 role="bold">System Backup</emphasis> window with a name following the
743 761 format: <literal>DatabaseExport_[date]_[timestamp].zip</literal>.</para>
744 <mediaobject>
745 <imageobject>
746 <imagedata align="center" contentwidth="615"
747 fileref="images/scheduled_backup.png" />
748 </imageobject>
749 </mediaobject>
750 </figure>
751
752 <para>The backups created will be visible in the
753 <emphasis role="bold">System Backup</emphasis> window with a
754 name following the format:
755 <literal>DatabaseExport_[date]_[timestamp].zip</literal>.</para>
756 </section> 762 </section>
757 </section> 763 </section>
758 764