cisco · 30 стр.

Cisco Guest Shell: Virtualized Linux Environment for Device Management (EN)

Оригинальное название: Cisco Guest Shell: Virtualized Linux Environment for Device Management

Читать онлайнСкачать PDF (1,3 МБ)

Похожие инструкции

Содержание

Текст документа

Restrictions for Guest Shell

Guest Shell Guestshell is a virtualized Linux-based environment, designed to run custom Linux applications, including Python for automated control and management of Cisco devices. It also includes the automated provisioning (Day zero) of systems. This container shell provides a secure environment, decoupled from the host device, in which users can install scripts or software packages and run them. This module describes Guest Shell and how to enable it.

Restrictions for Guest Shell, on page 1 Information About the Guest Shell, on page 2 How to Enable the Guest Shell, on page 12 Configuration Examples for the Guest Shell, on page 21 Additional References for Guest Shell, on page 27 Feature Information for Guest Shell, on page 27 Restrictions for Guest Shell • NETCONF sessions cannot be established on the standby Route Processor (RP). • Python scripts fail when running commands like the show tech-support wireless command, when the scale is set to 2000Aps, and clients are set to 10000. The output of commands like show tech-support wireless is huge and can cause memory exhaustion inside the Guest Shell.

When using commands with huge output, redirect the output to a file. The IOS CLI can write the output to a file in the /bootflash/guest-share directory, and it can be accessed from the Guest Shell. • Cisco Catalyst 9200CX Series Switches do not support the Management interface, AppGigabitEthernet interface, or VirtualPortGroup interface. Applications or scripts running in the Guest Shell will not be able to communicate with the external network. • In Cisco IOS XE 17.16.1 and later releases, Catalyst 9200CX Series Switches will use VirtualPortGroup interface with Network Address Translation (NAT) to communicate with the external network.

This communication is only supported for day zero ZTP running in Guest Shell. • When you run a Python script inside Guest Shell, background services are unable to access the dohost command. As a workaround, run the Python script without the sudo command, or use sudo with the -E option. Guest Shell 1

Стр. 1

Guest Shell Software Requirements

Information About the Guest Shell Guest Shell Overview The Guest Shell is a virtualized Linux-based environment, designed to run custom Linux applications, including Python, for automated control and management of Cisco devices. Using the Guest Shell, you can also install, update, and operate third-party Linux applications. The Guest Shell is bundled with the system image and can be installed using the guestshell enable Cisco IOS command. The Guest Shell environment is intended for tools, Linux utilities, and manageability rather than networking. Guest Shell shares the kernel with the host (Cisco switches and routers) system.

Users can access the Linux shell of Guest Shell and update scripts and software packages in the container root filesystem. However, users within the Guest Shell cannot modify the host file system and processes. Guest Shell container is managed using IOx. IOx is Cisco's Application Hosting Infrastructure for Cisco IOS XE devices. IOx enables hosting of applications and services developed by Cisco, partners, and third-party developers in network edge devices, seamlessly across diverse and disparate hardware platforms. Guest Shell Software Requirements The Guest Shell container allows users to run their scripts and apps on the system.

The Guest Shell container on Intel x86 platforms will be a Linux container (LXC) with a CentOS 8.0 minimal rootfs. You can install other Python libraries such as, Python Version 3.0 during runtime using the Yum utility in CentOS 8.0. You can also install or update python packages using PIP. Table 1: Guest Shell Software Requirements Guest Shell Information About the Guest Shell Guest Shell (LXC Container) Operating System Cisco IOS XE Platform All supported Cisco IOS XE platforms Guest Shell Environment • CentOS 7 supported in Cisco IOS XE Amsterdam 17.2.1 and previous releases. • CentOS 8 supported in Cisco IOS XE Amsterdam 17.3.1 and later releases. Note CentOS supports only Python 3.6.

Python 2.7 Supported till Cisco IOS XE Amsterdam 17.3.1 Guest Shell 2

Стр. 2

Hardware Requirements for the Guest Shell

Guest Shell Security Cisco provides security to ensure that users or apps in the Guest Shell do not compromise the host system. Guest Shell is isolated from the host kernel, and it runs as an unprivileged container. Hardware Requirements for the Guest Shell This section provides information about the hardware requirements for supported platforms which have variable memory configurations. Table 2: Guest Shell Resource Requirements Guest Shell Guest Shell Security Guest Shell (LXC Container) Python 3.6 Supported in Cisco IOS XE Amsterdam 17.1.1 and later releases. In Cisco IOS XE Amsterdam 17.1.1 and Cisco IOS XE Amsterdam 17.2.1, Python V2 is the default.

However, in Cisco IOS XE Amsterdam 17.3.1 and later releases, Python V3 is the default. Note Cisco Catalyst 9200 Series Switches support Python version 3 in Cisco IOS XE Amsterdam 17.3.1 and later releases.

Pre-installed Custom Python Libraries • Cisco Embedded Event Manager • Cisco IOS XE CLIs • NCCLIENT library for the NETCONF API Supported Rootfs SSH, Yum install, and Python PIP install GNU C Compiler Not supported RPM Install Supported Architecture x86 and ARM Platforms Minimum Memory Cisco 1000 Series Integrated Services Routers 4 GB Cisco Catalyst 8000V Edge Software 4 GB Cisco Cloud Services Router 1000V Series 4 GB Cisco ISR 4000 Series Integrated Services Routers 8 GB DRAM (In Cisco IOS XE Fuji 16.8.1 and previous releases.) 4GB DRAM (In Cisco IOS XE Fuji 16.8.1 and later releases.) Guest Shell 3

Стр. 3

Guest Shell Storage Requirements

All other platforms are shipped with sufficient resources to support Guest Shell. Virtual-service installed applications and the Guest Shell container cannot co-exist. Note Guest Shell Storage Requirements Cisco Catalyst 9300 Series Switches and Cisco Catalyst 9500 Series Switches require 1100 MB free hard disk space for Guest Shell to install successfully. On Cisco 4000 Series Integrated Services Routers, the Guest Shell is installed on the Network Interface Module (NIM)-Solid State Drive (SSD) (hard disk), if available. If the hard disk drive is available, there is no option to select bootflash to install Guest Shell.

Cisco 4000 Series Integrated Services Routers require 1100 MB free hard disk (NIM-SSD) space for Guest Shell to install successfully. For Cisco 4000 Series Integrated Services Routers and Cisco ASR 1000 Series Aggregation Services Routers (when an optional hard disk has been added to that router) you can only do resource resizing if you have installed the Guest Shell on the hard disk and inserted the hard disk into the router. A Guest Shell installed via bootflash does not allow you to do resource resizing using application hosting configuration commands. Note During Guest Shell installation, if enough hard disk space is not available, an error message is displayed.

The following is a sample error message on an Cisco ISR 4000 Series Integrated Services Router % Error:guestshell_setup.sh returned error:255, message: Not enough storage for installing guestshell. Need 1100 MB free space. Bootflash or hard disk space can be used to store additional data by Guest Shell. On Cisco 4000 Series Integrated Services Routers, Guest Shell has 800 MB of storage space available. Because Guest Shell accesses the bootflash, it can use the entire space available. Table 3:

Resources Available to Guest Shell and Guest Shell Lite Guest Shell Guest Shell Storage Requirements Resource Default Minimum/Maximum CPU 1% Note 1% is not standard; 800 CPU units/ total system CPU units. 1/100% Memory 256 MB 512 MB (Cisco Catalyst 8000V Edge Software and Cisco Cloud Services Router 1000V Series) 256/256 MB 512/512 MB (Cisco Catalyst 8000V Edge Software and Cisco Cloud Services Router 1000V Series) Guest Shell 4

Стр. 4