CUDB VNF Lifecycle Management

Contents

1Introduction
1.1Purpose and Scope
1.2Revision Information
1.3Target Groups
1.4Typographic Conventions
1.5Prerequisites
1.5.1Hardware and Software

2
Onboarding

3
Procedures
3.1Instantiate vCUDB VNF
3.1.1Preparation
3.1.2Instantiate vCUDB Node
3.2Terminate vCUDB VNF
3.2.1Terminate vCUDB Node

4
Troubleshooting

Glossary

Reference List

1   Introduction

This document describes system administration tasks performed in the Virtualized Network Function (VNF) Lifecycle Manager (VNF-LCM). The VNF-LCM provides a workflow execution environment and a web-based application for managing VNF lifecycle procedures.

The workflows are ordered sequences of steps for automating common use cases of the VNFs. A workflow provides a means to orchestrate simple and complex sequences of manual or automated tasks.

1.1   Purpose and Scope

This document covers the following workflow-based lifecycle management procedures:

This workflow is only suitable for CUDB system maiden installations but not for CUDB system expansions.

1.2   Revision Information


Rev. A

Initial release.

1.3   Target Groups

This document is intended for system administrators operating CUDB systems.

1.4   Typographic Conventions

Typographic conventions can be found in the following document:

1.5   Prerequisites

This section describes the prerequisites that must be fulfilled before the CUDB is installed.

Before starting this procedure, ensure that CUDB Release Notes and the documents listed in Reference List are available.

1.5.1   Hardware and Software

The following virtual and physical hardware and software are required:

2   Onboarding

This section describes how to prepare for workflow-based VNF operations using VNF-LCM. Performing this procedure is a prerequisite for lifecycle operations.

Execute the following commands on the VNF-LCM Services Virtual Machine (VM):

  1. Connect to VNF-LCM:

    ssh cloud-user@<VNFLAF-services_ip>

  2. Copy the CUDB Workflow pack CUDB_VNFLCM_WORKFLOWS-CXP9040847.tar file into /home/cloud-user directory.
  3. Decompress the CUDB Workflow pack CUDB_VNFLCM_WORKFLOWS-CXP9040847.tar

    [cloud-user@vnflaf-services ~]$ tar -xvf CUDB_VNFLCM_WORKFLOWS-CXP9040847.tar

  4. Install the CUDB Workflow pack:
    1. Switch to root user on vnflaf-services VM:

      [cloud-user@vnflaf-services ~]$ su – root

      [root@vnflaf-services ~]#

    2. Verify that the pack is not installed, by running the list command:

      rpm -qa |grep ERICvCUDB

    3. Uninstall the previous version, if there is one, and take the input data from the previous printout:

      # wfmgr bundle uninstall --package=<Name> --version=<Version>

    4. To install the Workflow pack, run the install command. The rpm file is located in the /tmp folder by default.

      # wfmgr bundle install --package=/tmp/<workflow_bundle_rpm_file>

      The expected output must be similar to the below example:

      -----------------------------------------------------------------------------------------------------------

package_name                         | pre_install   | install    | post_install    |             message |

------------------------------------------------------------------------------------------------------------

| ERICvCUDB_CXP9035445-1.9.20-1.noarch.rpm |   success   | success |   success    | package installation successful |

------------------------------------------------------------------------------------------------------------

      For more information on the output of the command, go to /var/log/wfmgr-cli-log/logfile.log.

For more information on installing workflows, refer to the Workflow Bundle Administration section of VNF-Lifecycle Manager System Administration Guide document in the OSS-RC documentation.

3   Procedures

This section describes how to perform LCM operations. VNF-LCM procedures use workflow instances.

Launch VNF-LCM from web browser:

http://<vnflaf-services_ip>/index.html#workflows

Figure 1 shows the example of VNF Lifecycle Management, where the workflow is shown.

Figure 1   Workflow Overview

3.1   Instantiate vCUDB VNF

This section describes how to instantiate a VNF using VNF-LCM.

This workflow can be used to install a vCUDB node. To install a CUDB system, this workflow must be executed several times, one for each VNF comprising the CUDB system. Instantiations must be launched consecutively without waiting for one to finish before launching the next one.

Note:  
If a vCUDB system consists of more than 10 CUDB VNFs, contact Ericsson personnel, once the instantiations are finished, to add a multiple SITE_VIP IPs in a live CUDB node.

3.1.1   Preparation

The following configuration files for one CUDB system must be available:

All the previous files must go under /vnflcm-ext/backups/workflows/cudbvnfd directory.

The final structure directory is created manually as shown in Figure 2.

Figure 2   Final Structure Directory

:

Note:  
Different vCUDB systems can be defined. Select one during instantiation of a VNF. Moreover, one CUDB system consists of one or several VNFs, that is, CUDB nodes.

All configuration files must be placed manually in the corresponding directories. Contact Ericsson personnel for finding the necessary files.

3.1.2   Instantiate vCUDB Node

  1. In the VNF-LCM Workflows screen, select Instantiate vCUDB Node and click Start a New Instance.
  2. Instance Name field is filled out, click Submit.

  3. Select the newly-created workflow from the Instance with User Tasks panel, and click on the man icon.
  4. On the Workflow Instance screen, add VNF Name, select VNF descriptor ID to instantiate, and click Submit.

    The Select VNF descriptor ID field displays VNF configurations available for instantiation in the /vnflcm-ext/backups/workflows/cudbvnfd/ directory.

  5. On the Get Instance Configuration screen, select a VNF configuration to instantiate, and click Submit.

    The Select Configuration for the VNF instance field displays VNF configurations available for instantiation in the /vnflcmext/backups/workflows/cudbvnfd/vCUDB_1/configurations directory.

    Refresh the web page.

  6. On the Select VIM screen, select a VIM, and click Submit.

  7. On the Select Tenant screen, select a Tenant, and click Submit.

Result: On the Workflow Instance screen, click on Workflow Diagram and Workflow Log to see the progress.

Note:  
Refresh the web page from time to time.

The workflow log shows the ongoing execution steps. The expected progress information output must be similar to the below example:

  1. Select VIM Info.
  2. Authenticate Cloud.
  3. Create Stack.
  4. Wait for LDE nodes.
  5. Wait for LDE nodes.
  6. Wait for CMW status OK.
  7. Regenerate cluster.conf.
  8. Install license key file.
  9. Execute PartTool.
  10. Copy runtime.
  11. CudbInstall, first step.
  12. Reconfigure Evip.
  13. CudbInstall, second step.
  14. Configure SnmpV3.
  15. Configure dscp.
  16. CudbInstall, third step.
  17. Configure SNMPV2.
  18. Restart services.
  19. Set environment variables.
  20. Check state.
  21. Get CudbSdpInfo.
  22. Initialize Database (DB).
  23. Order maintenance.
  24. PrepareStore in DB.
  25. Order ready in DB.
  26. Restart LdapFes.
  27. ApplyInitialConfig.
  28. ApplyInitialConfigC2L.
  29. Check status.
  30. Run CudbSwBackup.
  31. Wait for remote node installation.
  32. Run CudbRemoteTrust.
  33. Start DB replication.
  34. Add fixed entries.

3.2   Terminate vCUDB VNF

This section describes how to terminate a VNF using VNF-LCM.

This workflow can be used to decommission a CUDB system and free the resources by executing it consecutively on each VNF comprising the CUDB system.

3.2.1   Terminate vCUDB Node

Continue with this procedure only if the VNF to be terminated is instantiated using the VNF-LCM:

  1. In the VNF-LCM Workflows screen, select Terminate VNF, and click Start a New Instance.
  2. Instance Name field is filled out, click Submit.
  3. Select the newly-created workflow from the Active Instances panel and click on the man icon.

    Result: Traffic stops after VNF is terminated. On the Workflow Instances screen, click on Workflow Diagram and Workflow Log to see the progress.

    Note:  
    Refresh the web page.

  4. On the Select VIM screen, select a VIM, and click Submit.

  5. On the Select Tenant screen, select a Tenant, and click Submit.

  6. On the Workflow Instances screen, select the VNF to terminate, and click Submit.

    Forceful termination: If VNF is forcefully terminated, all ongoing traffic will be lost. This option must be confirmed on the next screen.

    Result: The VNF instance is terminated. On the Workflow Instances screen, click on Workflow Diagram and Workflow Log to see the progress.

    Note:  
    Refresh the web page.

4   Troubleshooting

If the workflow execution is unsuccessful, see the following options for more information on the cause of failure:


Glossary

For the terms, definitions, acronyms and abbreviations used in this document, refer to CUDB Glossary of Terms and Acronyms, Reference [1].


Reference List

CUDB Documents
[1] CUDB Glossary of Terms and Acronyms, 0033-HDA 104 03/10
ENM CPI Library References
[2] VNF-LCM Installation Instructions, 1/1531-CNA 403 3313
[3] ENM Configuration System Administration Guide, 1/1543-AOM 901 151-1
OSS-RC CPI Library References
[4] VNF-LCM CEE/Openstack Installation Instructions, 1/153 72-APR 901 0578
[5] VNF-Lifecycle Manager System Administration Guide, 1543-APR 901 0578


Copyright

© Ericsson AB 2018. All rights reserved. No part of this document may be reproduced in any form without the written permission of the copyright owner.

Disclaimer

The contents of this document are subject to revision without notice due to continued progress in methodology, design and manufacturing. Ericsson shall have no liability for any error or damage of any kind resulting from the use of this document.

Trademark List
All trademarks mentioned herein are the property of their respective owners. These are shown in the document Trademark Information.

    CUDB VNF Lifecycle Management