Re: IOx Docker app on Cisco ISR1K, C1117-4PWE, is this possible?

DeanMoore · ‎09-27-2019

Morning,

I was looking for some advice/information on whether I should carry on learning about IOx to deploy a simple Python based app to monitor the router status on a ISR1K. This will do the guestshell deployment but Im having issues getting it to run services and not just one time scripts.

If it is possible, I have tried to get the perfsonar app to deploy but there is an issue with the schema version for package.yaml, are there any good sources for training?

Thanks

Dean

suressan · ‎09-27-2019

Pls share your app pkg tar archive. You can follow through hands-on training at
https://developer.cisco.com/docs/sandbox/#!iot/featured-labs

For detailed docs,
Https://developer.cisco.com/docs/iox

DeanMoore · ‎09-27-2019

Thank you for the documents. The package file is +440mb in size but I followed the guide as per https://github.com/CiscoIOx/perfsonar it needed a few tweaks tho

suressan · ‎09-27-2019

Pls share your package.yaml, the step which is triggering the error and exact error msg you are getting.

DeanMoore · ‎09-30-2019

HI,

This is the error I get, I've tried to find which version of schema is support but had no luck.

z1898533#$onar package flash:output/perfsonar-testpoint.v4.1.c1.1.0.tar
% Error: Given schema version 2.9 is not supported

z1898533#

The package.yaml

$ cat package.yaml
descriptor-schema-version: "2.9"
info:
  name: perfsonar
  description: Cisco IOx PerfSONAR Application
  version: "1.1.0"
  author-name: Cisco
app:
  # Indicate app type (vm, docker)
  cpuarch: x86_64
  type: docker

  env:
    PATH: /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
    PG_VERSION: "9.5"
    PGDATA: /var/lib/pgsql/9.5/data
    PGVERSION: "95"

  resources:
    profile: custom
    vcpu: "2"
    cpu: "4000"
    disk: "1"
    memory: "2048"

    ramfs:
      size: "64"

    network:
    - interface-name: eth0
      type: external
      hint: "Application Public External Interface"
      ports: {}

# Specify runtime and startup
  startup:
    rootfs: rootfs.tar
    target: /etc/init.d/iox_start.sh

ktuffent · ‎10-02-2019

Dean,

After some testing, I think the following package.yaml will work. To use the package.yaml we can run the command "ioxclient docker package somebody/iox-test:latest ." substituting somebody/iox-test:latest for the image's tag and version. Viewing the issues with the package.yaml can be seen with the following command.

$ ioxclient docker package somebody/iox-test:latest . | grep "-"

After some research and reviewing, https://docs.docker.com/compose/compose-file/compose-file-v2/ resulted in the following file.

package.yaml

descriptor-schema-version: "2.9"
info:
  name: perfsonar
  description: Cisco IOx PerfSONAR Application
  version: "1.1.0"
  author-name: Cisco
app:
  # Indicate app type (vm, docker)
  cpuarch: x86_64
  type: docker
  env:
    PATH: /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
    PG_VERSION: "9.5"
    PGDATA: /var/lib/pgsql/9.5/data
    PGVERSION: "95"
  resources:
    profile: custom
    vcpu: "2"
    cpu: "4000"
    disk: "1"
    memory: "2048"
    network:
    - interface-name: eth0
      type: external  
      hint: "Application Public External Interface"
      ports: {}
  startup:
    rootfs: rootfs.tar
    target: /etc/init.d/iox_start.sh

Please, test the file out and let me know the results.

Thank you,
Kyle

DeanMoore · ‎10-03-2019

Hi,

Thanks for the help, although it did not directly help it did send me down the right rabbit hole to install a custom docker image.

I'll managed to generate a package.tar (I renamed it crs-docker.tar) I've overcome some CPU architecture issues but getting this error that has me stumped

z1898533#app-hosting install appid perfsonar package flash:crs-docker.tar
% Error: guestshell_setup.sh returned error: 255, message: Installing apps on system flash is not allowed.

yawming · ‎10-04-2019

What is your IOS version ? You may need 16.12 and later to support 2.9 schema.

DeanMoore · ‎10-07-2019

@yawming wrote:
What is your IOS version ? You may need 16.12 and later to support 2.9 schema.

Morning, Currently on 16.10.2, I believe the schema I have for my own docker image is 2.7. ioxclient generated it, is there a table somewhere with what versions are support on what IOS version?

Dean

ktuffent · ‎10-25-2019

Dean,

I see that your message is the following.

z1898533#app-hosting install appid perfsonar package flash:crs-docker.tar
% Error: guestshell_setup.sh returned error: 255, message: Installing apps on system flash is not allowed.

After some research the error message, the message is literal and the commands will need to be run on a device with non-flash storage.

Regards,

Kyle

DeanMoore · ‎10-25-2019

Hi Kyle,

Thanks for the update, does this mean the ISR C1117-4PWE is not capable of running docker images?

Dean

ktuffent · ‎10-25-2019

Dean,

The Cisco ISR1K does not support the IOx Docker app.

Regards,

Kyle

inkubus · ‎09-26-2021

Hi @ktuffent

do you know if lxc hosting possible for C111x series? If docker is no available, can is it possible to swap the guestshell to some other image?

Flo Pachinger · ‎10-18-2021

Hey @inkubus, it is not supported to host 3^rd party containers on the ISR1k, but you can install the guesthell container.