• Introduction
  

Smart Cities is an edge resource scheduling solution.

This guide setup a cluster network, one switch run with k3s server , one Nvidia Nona run with k3s node.

EdgeFaaS provide API to access the cluster network's capability.

• License

Apache License v2.0

• How to use this document

The document describes how to compile demo app from source code, and deploy to device.

• Deployment Architecture

• Pre-Installation Requirements

• Deploy Device Requirements

  • Network Switch run with SONiC
    • CPU core: 4
    • RAM: 4G
    • HDD: 16G
  • Nvidia Nano run with Jetson
    • CPU core: 4
    • RAM: 2G
    • HDD: 32G

• Complie Device Requirements

  1. Arm64 device run with Ubunut 18.04+
  2. CPU core: 4
  3. RAM: 4G
  4. HDD: 32G
  5. Rust 1.54.0 +
  6. Docker 20.10.1+
  7. Golang 1.16+

• Build PARSEC

$ git clone git clone "https://gerrit.akraino.org/r/a/cassini"

$ cd cassini/smartcities/parsec

$ cargo build --release --features "mbed-crypto-provider,direct-authenticator"

The compiled binary executable is in ./target/release/parsec.

Template of config file is in ./config.toml, it will be modify when deloy.

Template of parsec.service file is in ./systemd-daemon/parsec.service it will be modify when deloy.

• Build Demo App

  • Build ParsecClient

    $ cd cassini/smartcities/ParsecClient/

    $ ./build.sh

    $ sudo docker images

    REPOSITORY TAG IMAGE ID CREATED SIZE

    parsec-client v1.0 aef2a010b6b5 3 months ago 17.3MB

    $ sudo docker save aef2a010b6b5 > parsec-client-v1.0-docker-aarch64.tar

    The saved parsec-client-v1.0-docker-aarch64.tar will use to delpoy on SONiC and Nvidia Nona.

  • Build NodeAuthServer

    $ cd cassini/smartcities/NodeAuthServer/

    $ go build

  • Build NodeAuthAgent

    $ cd cassini/smartcities/NodeAuthAgent/

    $ go build

  • Build CameraClient

    $ cd cassini/smartcities/CameraClient/

    $ go build

  • Build TritonClient

    $ cd cassini/smartcities/TritonClient/

    $ ./build.sh

    $ sudo docker images

    REPOSITORY TAG IMAGE ID CREATED SIZE

    triton-client v1.0 deaf4b1027ed 3 weeks ago 1.32 GB
    

    $ sudo docker save deaf4b1027ed > triton-client-v1.0-docker-aarch64.tar


    The saved triton-client-v1.0-docker-aarch64.tar will use to delpoy on Nvidia Nona.

• Deploy Demo App on SONiC

  • Connect to SONiC

    Use serial console connect to SONiC device, serial param is below:

    Baud rate: 115200

    Data bit: 8

    Parity: None

    Stop bits: 1

    Contorol: None

  • Deploy Parsec server

    • add system user parsec (NEED login by admin)

      $ sudo useradd -m parsec

      $ sudo passwd parsec

      $ sudo usermod -s /bin/bash parsec

      $ sudo groupadd parsec-clients

    • create necessary directorys (NEED login by admin)
      

      $ sudo mkdir /var/lib/parsec

      $ sudo chown parsec:parsec /var/lib/parsec

      $ sudo chmod 700 /var/lib/parsec

      $ sudo mkdir /etc/parsec

      $ sudo chown parsec:parsec /etc/parsec

      $ sudo chmod 700 /etc/parsec

      $ sudo mkdir /usr/libexec/parsec

      $ sudo chown parsec:parsec /usr/libexec/parsec

      $ sudo chmod 700 /usr/libexec/parsec

      $ sudo mkdir /home/parsec/run/

      $ sudo chown parsec:parsec-clients /home/parsec/run/

      $ sudo chmod 750 /home/parsec/run/

    • deploy files (NEED login by parsec)

      $ cd ~

      $ pwd

      /home/parsec

      $ cp xxx/parsec/target/release/parsec /usr/libexec/parsec

      $ chmod +x /usr/libexec/parsec/parsec

      $ cp xxx/parsec/config.toml /etc/parsec/config.toml

      Note: need unmark allow_root = true in config.toml.
    • add service for systemctl

      $ sudo vim /etc/systemd/system/parsec.service
      [Unit]
      Description=Parsec Service
      Documentation=https://parallaxsecond.github.io/parsec-book/parsec_service/install_parsec_linux.html

      [Service]
      WorkingDirectory=/home/parsec/
      ExecStart=/usr/libexec/parsec/parsec --config /etc/parsec/config.toml

      [Install]
      WantedBy=multi-user.target

    • start parsec servive

      $ sudo systemctl enable parsec.service

      $ sudo systemctl start parsec.service

  • Deploy Parsec Client

    • import docker image parsec-client-v1.0-docker-aarch64.tar.

      $ sudo docker load < parsec-client-v1.0-docker-aarch64.tar

      $ sudo docker images

      $ sudo docker tag d396f7adeed3 parsec-client:v1.0

    • run the image with --restart=always, then test the client work with parsec server$ sudo docker run --restart=always -d -p8300:8300 -v /home/parsec/run:/run/parsec parsec-client:v1.0
      $ curl -v -d '{"Name": "GoClient"}' 127.0.0.1:8300/client
      ...
      HTTP/1.1 200 OK
      ...
    • create key pairs and export the public key, later the public key will import to Nvidia nano device.

      $ curl -v -d '{"Name": "GoClient"}' 127.0.0.1:8300/client

      $ curl -v -d '{"Name": "GoClient", "KeyName": "MyEncKey"}' 127.0.0.1:8300/keyenc

      $ curl -v -X GET -d '{"Name": "GoClient", "KeyName": "MyEncKey"}' 127.0.0.1:8300/key

  • Deploy NodeAuthServer

  • Deploy k3s Server

  • Deploy EdgeFaas

• Deploy Demo App on Nvidia Nano

• Maintenance

Blue Print Package Maintenance

• Frequently Asked Questions

N/A

• License

Any software developed by the "Akraino Enterprise Applications on Smart Cities is licensed under the
Apache License, Version 2.0 (the "License");
you may not use the content of this software bundle except in compliance with the License.
You may obtain a copy of the License at <https://www.apache.org/licenses/LICENSE-2.0>

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

• References

N/A

• Definitions, acronyms and abbreviations

N/A