CEE Library Overview

Cloud Execution Environment

1	Introduction
1.1	Product Numbers
1.2	Library Distribution and Access
1.3	Library Access
1.4	Library Structure
1.5	Document Types
1.6	Related Information
2	Cloud Execution Environment Library
2.1	Safety and Environment
2.2	Library Overview
2.3	Product Overview
2.4	Planning
2.5	Installation
2.6	Initial Configuration
2.7	Operation and Maintenance
2.8	Emergency
2.9	Interface

1 Introduction

This Library Overview presents the information available for Cloud Execution Environment (CEE).

1.1 Product Numbers

The product numbers and delivery information is provided in Table 1.

Table 1 Product Numbers
Product Name	Product Number	Library
CEE R6 R5A	AZE 102 01/5 R5A	EN/LZN 792 0001/8 R5A

1.2 Library Distribution and Access

CPI libraries are distributed as follows:

Online libraries on the Ericsson eBusiness portal – requires access privileges
Online libraries on CPI Store on the Ericsson intranet
Online libraries on CAL Store on the Ericsson intranet

1.3 Library Access

For information on how to access the library, refer to How to Get Started with Active Library Explorer.

1.4 Library Structure

The library consists of documents grouped into the following main folders:

Safety and Environment
Library Overview
Product Overview
Planning
Installation
Initial Configuration
Operation and Maintenance
Emergency
Interface

1.5 Document Types

The documents are grouped into the following three types:

Descriptive documents contain descriptions of the product on different levels.
Operational documents give instructions on how to operate or maintain the product.
Reference documents contain more information to which a user needs to refer.

1.6 Related Information

Trademark information, typographic conventions, definition, and explanation of acronyms and terminology used in this library, refer to the following documents:

2 Cloud Execution Environment Library

This section describes the library contents for CEE.

2.1 Safety and Environment

Documents included in this area are listed in Table 2. These documents are intended for personnel who work with Ericsson products.

Table 2 Safety and Environment
Title	Description	Type
Personal Health and Safety Information	Information important for health and safety in the workplace and in the external environment.	Descriptive, Operative
System Safety Information	Information important for product safety.	Descriptive, Operative

2.2 Library Overview

Documents included in this area are listed in Table 3. These documents are intended for all personnel involved in work related to any aspect of the product.

Table 3 Library Overview
Title	Description	Type
CEE Library Overview	Overview of the library.	Reference
Glossary of Terms and Acronyms	Explanations of all terms, abbreviations, and acronyms that occur in the library.	Reference
Trademark Information	Trademark information used in the library.	Reference
Typographic Conventions	Typographic conventions used in the library.	Reference
How to Get Started with Active Library Explorer	Introduction to the use of Active Library Explorer to read Ericsson CPI.	Reference

2.3 Product Overview

Documents included in this area are listed in Table 4. These documents are intended as an introduction for all personnel who want to learn more about the product.

Table 4 Product Overview
Title	Description	Type
CEE Technical Description	This document is a technical description of the product.	Descriptive
Atlas Overview	This document describes the CEE management system Atlas. For detailed information about using the Atlas Dashboard, refer to Atlas Dashboard Administrator User Guide and Atlas Dashboard End User Guide.	Descriptive
Free and Open Source Software	This document contains notices and license documentation related to the Free and Open Source Software (FOSS) that is included in CEE.	Descriptive
CEE R6 License Package List	This document contains the 3PP license packages used by Mirantis OpenStack v9.0.	Descriptive

2.4 Planning

Documents included in this area are listed in Table 5. These documents are intended for personnel responsible for planning, implementation, and product handling.

Table 5 Planning
Title	Description	Type
CEE R6 Network Impact Report	This document describes the changes within current release of CEE R6 compared to CEE 16A and the operator's overall network, including all affected products and functions.	Descriptive
Multi-Server System Dimensioning Guide, CEE R6	This document describes the generic HW requirements and characteristics and dimensioning of CEE. This document is valid for multi-server configuration.	Descriptive
HP System Dimensioning Guide, CEE R6	This document describes CEE HW requirements and characteristics and dimensioning of CEE. This document is valid for HP platform.	Descriptive
BSP System Dimensioning Guide, CEE R6	This document describes CEE HW requirements and characteristics and dimensioning of CEE. This document is valid for Blade Server Platform (BSP) platform.	Descriptive
Single Server System Dimensioning Guide, CEE R6	This document describes CEE HW requirements and characteristics and dimensioning of CEE. This document is valid for single server deployment.	Descriptive
Customer Acceptance Test Object List	This document contains the list of test cases described in Customer Acceptance Test Specification and summarizes the results of the customer acceptance test.	Operative
Customer Acceptance Test Specification	This document provides cases to execute a customer acceptance test of the functionality of CEE 16A.	Operative

2.5 Installation

Documents included in this area are listed in Table 6. These documents are intended for personnel performing hardware installation, software installation, and configuration.

Table 6 Installation
Title	Description	Type
Common CEE Installation Documents
CEE Installation	This document describes the complete procedure for deploying a CEE region.	Operative
Preparation of Kickstart Server	This document describes the preparation of the installation laptop that is used for the CEE SW installation process.	Operative
SW Installation in Single Server Deployment	This document describes procedures for installing the SW in a CEE region. This document is valid for single server deployment.	Operative
SW Installation in Multi-Server Deployment	This document describes procedures for installing the SW in a CEE region. This document is valid for multi-server deployment.	Operative
Dell Installation
Dell PowerEdge R630 HW Installation	This document describes procedures for installing Dell PowerEdge R630 for CEE.	Operative
Dell PowerEdge R630 Server Configuration	This document describes procedures for configuring Dell PowerEdge R630 server for CEE.	Operative
Dell PowerEdge R630 Server BIOS Configuration for CEE	This document describes procedures for configuring BIOS settings for a newly inserted Dell PowerEdge R630 server in CEE.	Operative
HP Installation
HP c7000 HW Installation	This document describes procedures for installing HP c7000 HW for CEE.	Operative
HP c7000 Configuration	This document describes procedures for configuring HP BladeSystem c7000 to be used in CEE.	Operative
HP c7000 Server BIOS Configuration	This document describes procedures for configuring the blade BIOS settings for a newly inserted blade in an 1.1 HP c7000 based CEE.	Operative
Extreme X670V Configuration	This document describes procedures for installing Extreme X670V Switches to be used as Traffic and Storage Switches.	Operative
Extreme X770 Configuration	This document describes procedures for installing Extreme X770 Switches to be used as Traffic and Storage Switches.	Operative
Extreme x460 Configuration	This document describes procedures for installing Extreme X460 Switches to be used as Control Switches.	Operative
VNX5400 SW Installation	This document describes the software installation of a VNX® 5400 model with VNX for Block (SAN) storage on CEE.	Operative
Atlas Installation
Atlas SW Installation	This document describes procedures for installing Atlas. Atlas is a cloud management tool, based on the OpenStack Dashboard, and delivered as a part of CEE.	Operative

2.6 Initial Configuration

Documents included in this area are listed in Table 7. These documents are intended for personnel performing SW installation and initial configuration.

Table 7 Initial Configuration
Title	Description	Type
Configuration File Guide	This document describes the configuration file changes to be made when installing CEE.	Operative, Descriptive
Fuel Plugin Configuration Guide	This document describes the different Fuel plugins available for the Cloud Execution Environment (CEE), and the mandatory Fuel plugins for a supported CEE configuration.	Operative, Descriptive

2.7 Operation and Maintenance

Documents within this area are listed in the subsections below. These documents are intended as an introduction for personnel involved in any operation and maintenance activity.

Table 8 Operation and Maintenance
Title	Description	Type
CEE Connectivity User Guide	This document provides an overview of the available interfaces in CEE, and instructions on how to connect to these. The document covers the interfaces from both a CEE user and CEE administrator point of view	Descriptive, Operative

2.7.1 Fault Management

Documents included in this area are listed in Table 9. These documents are intended for personnel performing fault handling, alarm handling, and troubleshooting.

Table 9 Fault Management
Title	Description	Type
Data Collection Guideline	This document provides step-by-step instructions required during data collecting activities.	Descriptive, Operative

2.7.1.1 Alarms

Documents included in this area are listed in Table 10. These documents are intended for personnel performing alarm handling.

Table 10 Alarms
Title	Description	Type
Bandwidth Overallocated due to Race Condition	The alarm is issued by the Managed Object (MO) `Node` when the periodic algorithm detects that the bandwidth requirement for the virtual machines (VMs) running on the node exceeds the available bandwidth.	Operative, Descriptive
Centralized Storage Alert	This alert is issued when an alert happens in Centralized Storage Array during running of CEE.	Operative, Descriptive
CIC Failed	This alarm is issued when the periodic supervision algorithm detects that one of the three Cloud Infrastructure Controllers (CICs) has failed the availability test three consecutive times, and, after that, remains unavailable for more than five minutes.	Operative, Descriptive
CIC Restarted	This alert is issued in the following situations: The periodic supervision algorithm detects that one of the CICs has failed the availability test three consecutive times, and, following that, it passes the test and becomes available again. A previously unknown CIC passes the availability test for the first time.	Operative, Descriptive
Complete CIC Service Restarted	This alert is issued for a Region by the Managed Object (MO) `CtrlDomain` when the periodic uptime measurements show that the uptime for all three CICs has decreased, which means that all CICs have been simultaneously unavailable.	Operative, Descriptive
Compute Host Failed	This alarm is issued by the MO `ComputeHost` when the periodic supervision algorithm detects that the Compute Host has failed the availability test three consecutive times, and, after that, remains unavailable for more than five minutes.	Operative, Descriptive
Compute Host Restarted	This alert is issued in the following situations: The periodic supervision algorithm detects that one of the Compute Hosts has failed the availability test three consecutive times, and, following that, it passes the test and becomes available again. A previously unknown Compute Host passes the availability test for the first time.	Operative, Descriptive
Core Dump Generated	This alarm is issued when a process fails. This alarm is generated when the memory content of the failed process is saved in a core dump. When the Linux kernel fails, the dump is called a crash dump.	Operative, Descriptive
Ethernet Port Aggregator Fault	This alarm is issued when the connection to the affected network is lost on both Ethernet ports.	Operative, Descriptive
Ethernet Port Fault	This alarm is issued when a network port on a server blade loses connectivity with the related network. The alarm remains active as long as the connectivity is missing. It is possible that the underlying fault requires site visit.	Operative, Descriptive
Ethernet Switch Port Fault	This alarm is issued by the MO `EthernetPort` when the connectivity is lost on an Ethernet switch in the "Top of Rack" switch.	Operative, Descriptive
Expiring Certificate	This alarm is issued by the MO `CtrlDomain` when the Certification Authority (CA) certificate is about to expire.	Operative, Descriptive
Fan Failure	This alarm is issued by the MO `Fan` when malfunction occurs in one or more cooling fans in the "Top of Rack" switch.	Operative, Descriptive
Fencing Failed	The alarm is issued by the MO `Node` when the periodic supervision algorithm detects that the compute host has failed the availability test three consecutive times, and `fence_compute_before_evacuation` was set to true (meaning that the compute will be fenced down), but fencing was not successful.	Operative, Descriptive
Fuel Failed	This alarm is issued when the periodic supervision algorithm detects that the Fuel host has failed the availability test three consecutive times, and, following that, remains unavailable for at least five minutes.	Operative, Descriptive
Fuel Restarted	The alert is issued in the following situations: The periodic supervision algorithm detects that the Fuel host has failed the availability test at least three consecutive times, and, following that, it passes the test and becomes available again. A previously unknown Fuel host passes the availability test for the first time.	Operative, Descriptive
High CPU Load	This alarm is issued by the MO `ServerBlade` when the load on the CPU is high.	Operative, Descriptive
High Local Disk Utilization	This alarm is issued by the MO `ServerBlade` when the local disk utilization is high.	Operative, Descriptive
High Memory Utilization	This alarm is issued by the MO `ServerBlade` when the memory utilization is high and exceeds a set threshold level.	Operative, Descriptive
NTP Authentication Failure	This alarm is issued when NTP Authentication Failure occurs. Network Time Protocol (NTP) service on Controller is not able to communicate with one of the upstream NTP servers according to authentication failure.	Operative, Descriptive
NTP Stratum Level Failure	This alarm is issued when NTP Stratum Level Failure occurs. That is, NTP stratum level on any of the CICs are lower or equal to any of the stratum levels on the upstream NTP servers.	Operative, Descriptive
NTP Upstream Server Failure	This alarm is issued when NTP Upstream Server Failure occurs. Upstream failure means that NTP client on CIC hosts cannot reach one of the upstream servers in the NTP server list.	Operative, Descriptive
Power Supply Failure	This alarm is issued by the MO `PowerSupply` when one or more power supplies fail in the "Top of Rack" switch.	Operative, Descriptive
Service Stopped	This alert is issued when a service operating at a host is stopped.	Operative, Descriptive
Service Permanently Stopped	This alarm is issued if a service operating at a vCIC or Compute node is stopped permanently.	Operative, Descriptive
VM Evacuation Failed	This alarm is issued for a Virtual Machine (VM) in the following situations: The automatic evacuation of the VM has failed. The evacuation of the VM is not allowed due to the evacuation policy of the VM.	Operative, Descriptive
VM Unavailable	This alarm is issued for a VM when the evacuation of the VM starts. The evacuation is triggered, and the alarm is issued, for all VMs that are hosted on the Compute Host that fails the periodical availability test three consecutive times.	Operative, Descriptive
VMs Restarted due to vSwitch Restart	This alert is issued when the VMs are restarted after a virtual Switch (vSwitch) failure in CEE. The alarm is issued by the MO Instance `VM`.	Operative, Descriptive

2.7.2 Configuration Management

Documents included in this area are listed in Table 11. These documents are intended for personnel performing configuration and fine-tuning. They are also intended for personnel performing provisioning.

Table 11 Configuration Management
Title	Description	Type
Atlas Dashboard End User Guide	This document describes the Ericsson Atlas Dashboard modifications, compared to the OpenStack Dashboard (Horizon). It also adds examples on features not described in the community user guide.	Operative, Descriptive
OpenStack End User Guide	This document is a user guide for OpenStack end users.	Operative, Descriptive
Atlas Dashboard Administrator User Guide	This document describes the Ericsson Atlas Dashboard modifications, compared to the OpenStack Dashboard (Horizon). It also adds examples on features not described in the community user guide.	Operative, Descriptive
OpenStack Administrator Guide	This document is a user guide for OpenStack administrators.	Operative, Descriptive
Atlas Multi-Region Configuration User Guide	This document describes procedures for enabling multiple CEE regions in Atlas.	Operative
Atlas On Demand Use	This document describes procedures for disabling Atlas in a single server CEE installation.	Operative, Descriptive
EMC ScaleIO Version 2.0.x User Guide	This document is a user guide for the EMC² ScaleIO storage solution	Operative, Descriptive
External Networking Connectivity for CEE Tenants in HP and Dell Multi-Server Deployment	This document describes procedures for configuring tenant external Border Gateways (BGWs) and Firewall (FW) connections to the CEE Region, in multi-server deployment.	Operative, Descriptive
External Networking Connectivity for CEE Tenants in Single Server Deployment	This document describes procedures for configuring tenant external Border Gateways (BGWs) and Firewall (FW) connections to the CEE Region, in single server deployment.	Operative, Descriptive
External Networking Connectivity for CEE Tenants in BSP Deployment	This document describes procedures for configuring tenant external Border Gateways (BGWs) and Firewall (FW) connections to the CEE Region, in BSP deployment.	Operative, Descriptive
Fault Management Configuration Guide	This document describes procedures for configuring the Watchmen Fault Management in CEE.	Operative, Descriptive
Runtime Configuration Guide	This document describes procedures configuring or reconfiguring settings in a running CEE.	Operative, Descriptive
Swift Store on VNX Activation	This document describes how to activate the feature Swift store on VNX and move the location of the Swift store from the local disks to the centralized storage (EMC VNX).	Operative
Swift Store on VNX Expansion	This document describes how to expand the existing Swift store on the VNX.	Operative
Swift Store on ScaleIO Activation	This document describes how to activate the feature Swift store on ScaleIO and move the location of the Swift store from the local disks to the distributed storage (EMC ScaleIO).	Operative
Swift Store on ScaleIO Expansion	This document describes how to expand the existing Swift store on ScaleIO.	Operative
vFuel On Demand Use	This document describes procedures for disabling/enabling vFuel on a Single Server environment.	Operative, Descriptive

2.7.3 Security Management

Documents included in this area are listed in Table 12. These documents are intended for personnel performing security tasks, including supervision and user administration. They are also intended for personnel performing hardening of the product.

Table 12 Security Management
Title	Description	Type
Security User Guide	This document describes Security Management for the supported security services in CEE.	Operative, Descriptive
EMC ScaleIO Version 2.0.x Security Configuration Guide	This document describes security management for EMC² ScaleIO storage solution.	Operative, Descriptive
System Hardening Guideline	This document contains general information about the hardening processes, and helps to understand the purpose of product hardening. The document gives an overview of the hardening activities that are performed during the product development, and defines hardening activities that need to be performed during and after the installation.	Operative, Descriptive
CEE Hardening Checklist	This document describes procedures for hardening that must be performed to make CEE secure during its whole life cycle.	Operative, Descriptive
Infrastructure Administrator Management Guide	This document describes the Cloud Execution Environment Identity and Access Management (CEE IdAM) tool, that is used to manage identities and credentials for Cloud Infrastructure Administrators, and to provide authentication and access control services for user accesses.	Operative, Descriptive
DC Firewall Hardening Guide	This document provides the connectivity and network description of the Data Center Firewall (DC-FW) to the Cloud Execution Environment Network (CEE Network) architecture. In the current system, FW is not part of the CEE Region, therefore this user guide gives a high-level overview about the external HW FW solution.	Operative, Descriptive

2.7.4 Hardware Management

Documents included in this area are listed in Table 13. These documents are intended for personnel performing preventive maintenance of the hardware and for personnel involved in troubleshooting.

Table 13 Hardware Management
Title	Description	Type
Replace Extreme X670V/X770 Switch	This document describes procedures for replacing the Extreme switch. The document is valid for both X670V and X770 switches.	Operative
Replace Extreme X460 Switch	This document describes procedures for replacing the Extreme x460 control switch.	Operative
Region Expansion	This document describes procedures for expanding an HP c7000 based CEE with one or more Compute hosts.	Operative
HP c7000 Server HW Expansion	This document provides hardware specific procedures for adding one or more blades as part of the hardware expansion of a version 1.1 HP c7000 based CEE with one or more Compute hosts.	Operative
Server Replacement	This document describes procedures for replacing a blade in the HP c7000 based CEE.	Operative
HP c7000 Server HW Replacement	This document provides hardware specific procedures for replacing a blade in a version 1.1 HP c7000 based CEE.	Operative

2.7.5 Software Management

Documents included in this area are listed in Table 14. These documents are intended for personnel performing preventive maintenance of the software and for personnel involved in troubleshooting. They are also intended for personnel performing backup and restoration.

Table 14 Software Management
Title	Description	Type
Atlas Software Management Guide	This document describes how to manage the Atlas software.	Descriptive, Operative
Atlas SW Upgrade	This document describes procedures for updating and upgrading the SW in an existing CEE Atlas Server.	Operative
Atlas Backup	This document describes procedures for backing up the configuration of Atlas for CEE. For more information about the atlas command used for the backup procedure, refer to Atlas Software Management Guide.	Descriptive, Operative
Atlas Restore	This document describes procedures for restoring the configuration of Atlas for CEE.	Descriptive, Operative
Fuel Synchronization	This document describes the manual Fuel synchronization procedure and the change to cold-stand-by vFuel.	Operative
CEE SW Update and Rollback	This document describes procedures for performing a CEE SW update or rollback between CEE R6 releases.	Operative
Extreme Switch Firmware Upgrade	This document describes procedures for upgrading the Firmware (FW) for the Extreme switch.	Operative

2.7.6 Health Check

Documents included in this area are listed in Table 15. These documents are intended for personnel performing installation, preventive maintenance of the software, and provisioning tasks. They are also intended for personnel involved in troubleshooting.

Table 15 Health Check
Title	Description	Type
Health Check Procedure	This document is to help support engineers check that CEE operates in a fault-free state, and to detect issues that can affect normal operation.	Descriptive

2.8 Emergency

Documents included in this area are listed in Table 16. These documents are intended for personnel authorized to perform an emergency recovery.

Table 16 Emergency
Title	Description	Type
Emergency Recovery Procedure	This document provides a systematic approach for resolving a system emergency experienced in CEE.	Descriptive

2.9 Interface

Documents included in this area are shown are listed in Table 17. These documents are intended for personnel needing to understand the logical entity, including interfaces and protocols.

Table 17 Interface
Title	Description	Type
OpenStack API Complete Reference	This document is a complete reference of the Application Programming Interface (API) operations and extensions of OpenStack.	Descriptive, Reference
OpenStack Orchestration API in CEE	This document is an introduction to the API of the OpenStack Dashboard-based cloud management component Atlas in CEE.	Descriptive, Reference
OpenStack Heat	This document describes the OpenStack Heat service and contains the Heat Orchestration Template (HOT) guide.	Descriptive, Reference
Atlas OVFT API	This document describes the Atlas Open Virtualization Format Translator (OVFT) API used in CEE.	Descriptive
Atlas OVF to HOT Mapping	This document describes a mechanism for translation of OVF descriptors into HOT templates.	Descriptive
Atlas CLI End User Guide	This document describes the syntax descriptions and examples of the commands used for managing Atlas by using the CLI.	Descriptive, Operative
In Service Performance Northbound API	This document describes the structure and content of the In-Service Performance (ISP) Log File in CEE.	Descriptive
Fault Management Northbound API	This document describes the Fault Management (FM) Northbound API used in CEE.	Descriptive
Performance Management Northbound API	This document describes the northbound interfaces of CEE used for Performance Management (PM).	Descriptive
Preconfigured Key Performance Indicators	This document describes the factory default key performance indicators (KPIs) available at the northbound interfaces of CEE used for performance management.	Descriptive
Audit and Security Logging	This document describes the Northbound Interface of the Log Aggregator that is part of CEE.	Descriptive
Security Information and Event Management	This document describes the interface between the external Security Information and Event Management (SIEM) systems and the Log Collector in Atlas.	Descriptive
OpenStack Identity API in CEE	This document is an introduction to using the API of the OpenStack component "Identity" (Keystone) in CEE.	Descriptive
OpenStack Compute API in CEE	This document is an introduction to using the API of the OpenStack component "Compute" in CEE.	Descriptive
OpenStack Networking API in CEE in BSP Deployment	This document describes how the API for networking is used in CEE in BSP deployment. The API is based on the OpenStack component "Networking" (Neutron).	Descriptive
OpenStack Networking API in CEE in HP and Dell Multi-Server Deployment	This document describes how the API for networking is used in CEE in HP and Dell Multi-server deployment. The API is based on the OpenStack component "Networking" (Neutron).	Descriptive
OpenStack Networking API in CEE in Single Server Deployment	This document describes how the API for networking is used in CEE in Single Server deployment. The API is based on the OpenStack component "Networking" (Neutron).	Descriptive
OpenStack Object Storage API in CEE	This document is an introduction to using the API of the OpenStack component "Object Storage" in CEE.	Descriptive
OpenStack Block Storage API in CEE	This document is an introduction to using the API of the OpenStack component "Block Storage" in CEE.	Descriptive
OpenStack Image Service API in CEE	This document is an introduction to using the API of the OpenStack component "Image Service" in CEE.	Descriptive
OpenStack Telemetry API in CEE	This document is an introduction to using the API of the OpenStack component "Telemetry" in CEE.	Descriptive