diff options
author | Toma Bilius <toma.bilius@enea.com> | 2021-08-12 13:14:08 +0300 |
---|---|---|
committer | Toma Bilius <toma.bilius@enea.com> | 2021-08-12 13:14:35 +0300 |
commit | 994a612560ec09a71d67f7521920e8e01ad243f3 (patch) | |
tree | 6962bd92d66b05b0be893aea2c64b96aff710027 | |
parent | 11db30366663a8f049c71a29d574e01da05e4dc1 (diff) | |
download | nfv-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.xml | 278 |
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 | ||