| 1 | Introduction |
2 | Description of Changes |
| 2.1 | New and Changed Documents |
| 2.1.1 | Library Overview |
| 2.1.2 | Product Overview |
| 2.1.3 | Planning |
| 2.1.4 | Installation |
| 2.1.5 | Initial Configuration |
| 2.1.6 | Operation and Maintenance |
| 2.1.7 | Emergency |
| 2.2 | Removed Documents |
1 Introduction
This document shows the changes in the vMRF library between the following releases:
|
From |
vMRF 1.6.0 EN/LZN 745 0023 R7A |
|
To |
vMRF 1.7.0 EN/LZN 745 0023 R8A |
The following changes are shown:
- Documents added
- Documents changed
- Documents removed
The reason for a change is described, for example, new, updated, or removed features, as well as corrected faults and responses to change requests.
Minor changes, however, such as language corrections, link errors, and editorial improvements are not shown in the tables below unless these are the only corrections in the update.
2 Description of Changes
The structure in this section reflects the structure of the current library.
2.1 New and Changed Documents
2.1.1 Library Overview
|
Title |
Identity |
Change |
|---|---|---|
|
Glossary of Terms and Acronyms |
Added the following terms in section Glossary: CLISS (CLI Secure Shell), VDP (Virtual Deployment Package), and vCD (vCloud Director). Added LFV (Logic File Validator) in Glossary. | |
|
Trademark Information |
New document | |
|
Free and Open Source Software |
Removed GlusterFS. | |
|
How to Get Started with Ericsson Library Explorer |
New document |
2.1.2 Product Overview
|
Title |
Identity |
Change |
|---|---|---|
|
vMRF Overview |
Support for Watchdog Feature updated with configurable parameters. DHCP support discontinued: updated that local IP addresses are either fetched from a predefined IP address pool, or provided manually instead of being fetched from a DHCP server in Address Resolution and Next Hop Supervision. Added that next hop IP addresses for IPv4 media networks, the O&M network, and signaling networks are fetched from the HOT and OVF template files instead of from a DHCP server in Address Resolution and Next Hop Supervision. Added note on IPv6 Stateless Address Autoconfiguration in Address Resolution and Next Hop Supervision. Updated row on enabling graceful shutdown of the VM in VMware Tools. Mentioned in section "Virtual Machine Functions in vMRF" that the internal VLAN must not be exposed to external networks. Added Internal VLAN to "Figure 3 VNF Architecture". | |
|
vMRF Infrastructure Requirements |
DHCP support discontinued: Removed DHCP-related information in row IP address allocation in Network Requirements. | |
|
vMRF Networks and Connectivity |
New document First version of document. |
|
Title |
Identity |
Change |
|---|---|---|
|
Virtual MRF High Level Statement of Compliance |
Editorial changes. |
2.1.3 Planning
|
Title |
Identity |
Change |
|---|---|---|
|
vMRF Network Impact Report |
Updated for 1.7.0. |
2.1.4 Installation
|
Title |
Identity |
Change |
|---|---|---|
|
VNF Life Cycle Management |
Updated file permission granting for jboss_user in Onboard the VNF Package on VNF-LCM for the small stack scenario. Updated Step 2 with the location of the script in Prepare VNF Deployment Parameters. Added flavor to the list of parameters not transferred from the old VNF, and that it is contained in the env.yaml file of the new VNF in Prerequisites in Upgrade VNF. Changed path /vnflcm-ext/backups/workflows/vnfd to /vnflcm-ext/current/vnf_package_repo. Changed path /vnflcm-ext/backups/workflows/vnfd to /vnflcm-ext/current/vnf_package_repo. Changed command chmod 770 to 777 for /vnflcm-ext/backups/workflows/vnfd/VNFType__VNFVersion/configurations. Updated main.yaml in Example in Onboard the VNF Package on VNF-LCM. Removed step on copying lcmScripts. Updated figures in Upgrade VNF. Updated Prepare Deployment Parameters procedure with small stack and full stack scenario specific instructions. New optional steps for backing up and restoring certificate files for the optional customer security layer between LM and NeLS in Upgrade VNF. Updated procedure in Onboard the VNF Package on VNF-LCM. "Onboard the VNF Package on VNF-LCM" renamed to "Onboard the Virtual Deployment Package on VNF-LCM". Minimum version requirements updated to the following: vIMS workflows: 1.12.0, VNF-LCM: 18.12 or higher (minimum SW media version: 4.7.13). Added new step for vIMS workflows 1.13.0 and higher for handling SSH keys in Onboard the Virtual Deployment Package on VNF-LCM. Updated private SSH keys folder path in Onboard the Virtual Deployment Package on VNF-LCM. Added EO-related content in Introduction, Prerequisites, and Prepare Deployment Parameters. Added new section Onboarding and its subsections. Added image in Onboarding. | |
|
VNF Life Cycle Management for VMware |
Correction in env-vcd.yaml example in Onboarding. Minimum version requirements updated to the following: vIMS workflows: 1.12.0, VNF-LCM: 18.12 or higher (minimum SW media version: 4.7.13). Updated note in step 2 on how to provide data with multiple line breaks in Onboarding. Added new step for vIMS workflows 1.13.0 and higher for handling SSH keys in Onboarding. Updated private SSH keys folder path Onboard the Virtual Deployment Package on VNF-LCM. Added example information for shared storage and announcement configurations in env-vcd.yaml file example in Onboarding. Updated fingerprint for announcement storage configuration in env-vcd.yaml file example in Onboarding. | |
|
Deployment Guide for Cloud Execution Environment (CEE) |
Added section "Define Anti-Affinity Policy in Specific Traffic Cases". Order of sections "Upload the Image" and "Prepare Deployment Parameters" is switched. Order of sections "Upload the Image" and "Prepare Deployment Parameters" is switched. Added new parameters watchdog_interval and watchdog_enable in Prepare Deployment Parameters. Added footnotes in section "Create Network Topology" and "Prepare Deployment Parameters" that the network reserved for future use is mandatory. YAML file example corrected in "Define Anti-Affinity Policy". Reference to "network reserved for future use" is removed in section "Create Network Topology". Parameter "rsrv_net_name" removed in section "Prepare Deployment Parameters". Specified that the parameter payload_instance_count controls the total number of VMs to be created in section "Prepare Deployment Parameters". Instantiation parameter changed from heat stack-create -f vmrf.yaml -e example_environment.yaml -P payload_instance_count=0 to heat stack-create -f vmrf.yaml -e example_environment.yaml -P payload_instance_count=1 in section "Instantiate and Check vMRF with One VM". DHCP support discontinued: removed table in Step 3 in Download and Extract vMRF Software Delivery Package. The only option is using the files in the cee folder. Added in Prepare Deployment Parameters that the shared storage and announcement server SSH key must be included in single quotation marks. Added command example on generating the private key input for announcement and shared storage servers in Prepare Deployment Parameters. Added in Prepare Deployment Parameters that shared storage and announcement storage server paths are POSIX paths. | |
|
Deployment Guide for OpenStack |
Added section "Define Anti-Affinity Policy in Specific Traffic Cases". Order of sections "Upload the Image" and "Prepare Deployment Parameters" is switched. Added new parameters watchdog_interval and watchdog_enable in Prepare Deployment Parameters. Added footnotes in section "Create Network Topology" and "Prepare Deployment Parameters" that the network reserved for future use is mandatory. YAML file example corrected in "Define Anti-Affinity Policy". Reference to "network reserved for future use" is removed in section "Create Network Topology". Parameter "rsrv_net_name" removed in section "Prepare Deployment Parameters". Specified that the parameter payload_instance_count controls the total number of VMs to be created in section "Prepare Deployment Parameters". Instantiation parameter change from heat stack-create -f vmrf.yaml -e example_environment.yaml -P payload_instance_count=0 to heat stack-create -f vmrf.yaml -e example_environment.yaml -P payload_instance_count=1 in section "Instantiate and Check vMRF with One VM". DHCP support discontinued: Removed DHCP-related information from Step 5 in Download and Extract vMRF Software Delivery Package. Added in Prepare Deployment Parameters that the shared storage and announcement server SSH key must be included in single quotation marks. Added command example on generating the private key input for announcement and shared storage servers in Prepare Deployment Parameters. Added in Prepare Deployment Parameters that shared storage and announcement storage server paths are POSIX paths. | |
|
Deployment Guide for VMware vSphere |
Clarified which vApp property is optional in Deploy the OVF Template. Added footnote on private key format to Announcement storage ssh private key in Deploy the OVF Template. Removed reference to "Content Library" as it is no longer supported with IP Pool deployments in section "Deploy the OVF Template". Removed section "Prerequisite for Future Deployments" Removed vAPP Property "LI IP address" and "LI Subnet mask length" in section "Deploy the OVF Template". Reference to "network reserved for future use" is removed. in section "Create Network Topology". Added footnote stating that PM data monitoring configuration is optional for platform automatic IP address allocation and added PM data monitoring in table for manual IP address allication Deploy the OVF Template. Added substep with table on setting VM properties in Deploy the OVF Template. Specified that the password for the emergency user can be changed only during deployment in section "Deploy the OVF Template". Added in Deploy the OVF Template that the announcement server SSH key must be included in single quotation marks. Added command example on generating the private key input for announcement and shared storage servers in Deploy the OVF Template. Added in Deploy the OVF Template that shared storage and announcement storage server paths are POSIX paths. | |
|
Deployment Guide for VMware vCloud Director |
Added footnote on private key format to Announcement storage ssh private key in Deploy vApp from the Catalog. Untrusted 1, Untrusted 2, and Trusted networks are replaced with "user plane network towards media networks" in section "Scale-out Using the Catalog". Note added in section "Power on vMRF vApp" on VM Configuration after Power on. Specified that the password for the emergency user can be changed only during deployment in section "Deploy vApp from the Catalog". Added in Deploy vApp from the Catalog that the announcement server SSH key must be included in single quotation marks. Added command example on generating the private key input for announcement and shared storage servers in Deploy vApp from the Catalog. Added in Deploy vApp from the Catalog that shared storage and announcement storage server paths are POSIX paths. | |
|
Upgrade Guide |
Added new step on backing up and re-adding certificates and certificate configuration file in Export Configuration Data from the Old Version and Deploy the New Version. |
2.1.5 Initial Configuration
|
Title |
Identity |
Change |
|---|---|---|
|
Initial Configuration Guide |
Editorial changes only. |
2.1.6 Operation and Maintenance
|
Title |
Identity |
Change |
|---|---|---|
|
CLI Commands |
Added table Status Verification Summary in verify_vmrf_cluster_status.py. Updated command access information from POSIX group to role in collectData.py. Changed “DHCP assigned IP:” to “IP address:" in command printout in section status. Command "cluster" introduced in section "vMRF Utility Scripts" as subsection. Column heading “Operational State” with “VM Status” in following clitool printouts: verify_vmrf_cluster_status.py, cluster list. |
|
Title |
Identity |
Change |
|---|---|---|
|
Managed Object Model for vMRF |
190 89-4/AXM 101 04/1 Uen M |
|
Title |
Identity |
Change |
|---|---|---|
|
Compute Resource Threshold Value Exceeded |
Editorial changes only. | |
|
License Management, Autonomous Mode Activated |
Editorial changes only. | |
|
License Management, Emergency Unlock Reset Key Required |
Editorial changes only. | |
|
License Management, Key File Fault |
Editorial changes only. | |
|
MRF Announcement File Missing |
Editorial changes only. | |
|
MRF Announcement Storage Unavailable |
Editorial changes only. | |
|
MRF H.248 Link Unavailable |
DHCP support discontinued: removed Step 1 on checking local signaling IP address in Local Endpoint Configuration Fault. | |
|
MRF Instance 80% Capacity Limit Exceeded |
Editorial changes only. | |
|
MRF Instance Overloaded |
Editorial changes only. | |
|
New document | ||
|
DHCP support discontinued: updated alarm description and remedy steps. | ||
|
MRF Media Stream Recording Active |
Editorial changes only. | |
|
MRF Next Hop Router Unreachable |
DHCP support discontinued: Removed DHCP-related information in MRF Next Hop Router Unreachable Alarm Description and removed Step 3 on checking DHCP server configuration in Cease the MRF Next Hop Router Unreachable Alarm. | |
|
Service Level Agreement Violation |
Editorial changes only. |
|
Title |
Identity |
Change |
|---|---|---|
|
Event List |
Editorial changes only. |
|
Title |
Identity |
Change |
|---|---|---|
|
vMRF Troubleshooting Guideline |
Note added on behaviour of alarms related to MrgfInstance while locking the VM in section "Manual Recovery Flow". DHCP support discontinued: Removed DHCP-related information in No Connection to NextHop. Changed "DHCP OK" to "STATIC" in command printout in No Connection to Client. Removed singaling-related trouble case No IP Address Available for Signaling. | |
|
Media Stream Recording |
Editorial changes only. |
|
Title |
Identity |
Change |
|---|---|---|
|
Data Collection Guideline |
Updated option -d with CLISS configuration. Option -a does not collect binaries. Added a note on binary collection for option -a. Added a list of commands run (CLI tool commands, System commands) for option -c. Defined that option -v results in the same data output as option -c, and provides the result of mpstat "-P ALL 5 1" too. eLo psr,pid,ppid,tid,pcpu,rss,time,comm,cmd corrected to ps eLo psr,pid,ppid,tid,pcpu,rss,time,comm,cmd in section "Overview of Data Collection". Added information on the "cluster run" option in the part on option "-c". Expanded and reordered information (added Gluster volume information and Cloud init data) on collected data for option "-d". "Overview of Data Collection": The data collection script does not collect Gluster volume related information any longer. |
|
Title |
Identity |
Change |
|---|---|---|
|
Configuration Management |
Scale-in Procedure in OpenStack: Updated note on scaling in VMs in Step 2. Replaced option -e and -f for heat stack-update with -x. Updated note in Step 4. Manual Scaling in VMware and its subsections added. Maximum number of PM files is changed to 500 from 250 in section "Configure Compression for Performance Management XML Files". Removed references to Content Library as it is no longer supported with IP Pool deployments in section "Scale-out Procedure". Added steps on Powering on the VM and checking it in addition to configuring it by Manual IP deployments in section Scale-out Procedure for VMware environments. Filepaths for basic and variable announcements are corrected in sections "Create a Basic Announcement", "Create a Variable Announcement" and "Handling of Announcement Files". Sections "Scale-out Procedure" and "Scale-in Procedure" renamed to "Scale-out Procedure in vCenter Environment" and "Scale-in Procedure in vCenter Environment" respectively. New sections introduced: "Scale-out Procedure in vCloud Environment" and "Scale-in Procedure in vCloud Environment". Untrusted Network 1, Untrusted Network 2, Trusted Network are removed from vMRF. vNIC3 is remapped to network for "User plane towards media networks". Added MO results in "Scale-out Procedure in vCloud Environment". Added MO results in "Scale-in Procedure in vCloud Environment". Scale-in example "payload_instance_count" is corrected in section "Scale-in Procedure". This parameter controls the total number of VMs. Section order reorganized. Added note on operationalState attribute in Step 5 in "Lock a VM". |
|
Title |
Identity |
Change |
|---|---|---|
|
File Management |
Command added for accessing the folders for the following file types: PM XML files, alarm and alert logs in section "Functions and Concepts". |
|
Title |
Identity |
Change |
|---|---|---|
|
Performance Indicators |
Added note on the maximum number of PM files in section "Performance Management Overview". |
|
Title |
Identity |
Change |
|---|---|---|
|
vMRF Security Management |
Specified that the Troubleshooter user also has root privileges in section "Reserved POSIX Groups". Added description of the "system-ts" POSIX group in section "Reserved POSIX Groups". Reference added to Deployment Guides regarding emergency user definition in section "Reserved POSIX Groups". Added MrfApplicationMomAccess in section "OAM Administrator Access Control". Removed SNMP over DTLS from table in Services, Ports, and Protocols. Added port 162 for SNMP traps in table in Services, Ports, and Protocols. Added footnotes for SNMP ports 161 and 162 in Services, Ports, and Protocols. | |
|
vMRF Hardening Guideline |
Added the default value for the name of the emergency user (mrsv-admin) in section "Hardening during Installation". |
|
Title |
Identity |
Change |
|---|---|---|
|
vMRF Backup and Restore Guideline |
Removed subsection Restore without Re-Deployment. |
|
Title |
Identity |
Change |
|---|---|---|
|
License Management |
Added new section vMRF Licenses and its subsections. | |
|
Update NeLS Connection |
Editorial changes only. |
2.1.7 Emergency
|
Title |
Identity |
Change |
|---|---|---|
|
Emergency Recovery Procedure for vMRF |
Editorial changes. |
2.2 Removed Documents
|
Title |
Identity |
Comment |
|---|---|---|
|
Trademark Information |
1/006 51-APA 901 44/1 Uen G |

Contents